一、基础路由配置

1. path函数的标准用法

在Django项目中，路由配置是连接URL与视图函数的桥梁。基础的path函数支持多种路径匹配模式：

path('home/', views.home)
path('news/<int:nid>', views.news)

path函数支持四种常用的路径转换器：

• int：匹配整数
• str：匹配非空字符串（默认）
• slug：匹配字母、数字、下划线和横杠的组合，如 news-<slug:article_slug>
• uuid：匹配UUID格式
• path：匹配包含斜杠的路径，如 /etc/config/

2. re_path正则匹配

从django.urls导入re_path函数，它允许使用正则表达式进行更灵活的路径匹配：

from django.urls import path, re_path

path与re_path的核心区别在于匹配机制：path进行纯字符串精确匹配，而re_path则支持正则表达式模式匹配。

使用正则表达式时，可以实现模糊匹配效果：

re_path(r"^case/case01", views.case_view)

上述配置表示只要URL以"case/case01"开头，后续无论跟随什么内容，都会命中该路由规则。

注意事项：

• 正则表达式中的圆括号代表分组，分组匹配到的内容会作为参数传递给视图函数
• 根路径后的首个路径无需前导斜杠，如case正确，/case错误
• 建议在正则字符串前加r前缀，避免转义字符问题

二、正则分组与参数传递

1. 无名分组

在正则表达式中使用圆括号创建分组，匹配到的内容会按位置顺序传递给视图函数：

# urls.py
re_path(r"^year/([0-9]{4})/$", views.case02)

# views.py
def case02(request, year):
    return HttpResponse(f"年份参数: {year}")

访问URL /year/2024/ 时，"2024"会被捕获并作为参数传递给视图函数。

当存在多个分组时，视图函数需要接收相应数量的参数：

re_path(r"^date/([0-9]{4})/([0-9]{2})/$", views.case02)

def case02(request, year, month):
    return HttpResponse(f"{year}年{month}月")

2. 有名分组

使用?P<name>语法可以定义命名分组，使参数按名称传递，与位置无关：

re_path(r"^case/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/$", views.case03)

def case03(request, month, year):
    return HttpResponse(f"月份: {month}, 年份: {year}")

即使视图函数中参数顺序与正则表达式中定义的顺序不同，Django仍能正确映射参数。

3. 路由匹配优先级问题

当多个正则规则存在时，Django会自上而下匹配。注意以下情况：

# 缺少结束符$
re_path(r"^case/([0-9]{4})/", views.case02)

# 带结束符$
re_path(r"^case/([0-9]{4})/$", views.case03)

访问 /case/2088/ 时，由于第一条规则没有结束符，会优先匹配，导致预期之外的路由被触发。建议始终在正则表达式末尾添加 $ 结束符以确保精确匹配。

三、路由分发与解耦

1. include实现模块化解耦

当项目包含多个应用时，应将路由分散到各应用内部，避免主urls.py过于臃肿。

项目主路由配置：

from django.urls import path, re_path, include

urlpatterns = [
    re_path(r"^blog/", include("blog.urls")),
    re_path(r"^shop/", include("shop.urls")),
]

应用内部路由（blog/urls.py）：

from django.urls import path, re_path
from blog import views

urlpatterns = [
    re_path(r"^article/(?P<id>\d+)/$", views.article_detail),
    path("list/", views.article_list),
]

访问 /blog/article/123/ 时，请求首先被分发到blog应用的urls.py进行二次匹配。

2. 自定义路由转换器

当标准转换器无法满足需求时，可以自定义转换器类：

from django.urls import register_converter

class PhoneConverter:
    regex = "1[3-9]\d{9}"
    
    def to_python(self, value):
        # URL匹配成功后转换为视图参数
        return int(value)
    
    def to_url(self, value):
        # 反向解析时转换为URL部分
        return str(value)

# 注册转换器
register_converter(PhoneConverter, "phone")

# 在路由中使用
path("contact/<phone:mobile>/", views.show_contact)

def show_contact(request, mobile):
    return HttpResponse(f"联系号码: {mobile}")

四、登录验证与请求分发

1. 区分GET与POST请求

同一URL可能需要同时处理GET和POST请求，可通过request.method属性区分：

from django.shortcuts import render, HttpResponse

def user_auth(request):
    if request.method == "POST":
        username = request.POST.get("username")
        password = request.POST.get("password")
        
        if username == "admin" and password == "123456":
            return HttpResponse("登录成功")
        else:
            return HttpResponse("登录失败")
    elif request.method == "GET":
        return render(request, "login.html")

对应的HTML表单：

<form action="/user/auth/" method="post">
    <input type="text" name="username" placeholder="用户名">
    <input type="password" name="password" placeholder="密码">
    <button type="submit">登录</button>
</form>

五、反向解析详解

1. HTML模板中的反向解析

为路由配置name参数后，可在模板中使用{% url '别名' %}语法生成URL，避免硬编码：

# urls.py
path('login/', views.user_auth, name="user_login")

<!-- 模板中使用 -->
<form action="{% url 'user_login' %}" method="post">

当路由路径变更时，模板中的URL会自动更新，无需手动修改。

2. 视图函数中的反向解析

在视图中使用reverse函数进行反向解析：

from django.urls import reverse

def my_view(request):
    # 基础反向解析
    url = reverse("user_login")
    # /login/
    
    # 带参数的反向解析
    url_with_params = reverse("article_detail", args=(101,))
    # /blog/article/101/
    
    return HttpResponse(url)

对于命名分组的路由：

re_path(r"^edit/(?P<id>\d+)/$", views.edit_view, name="edit_article")

def some_view(request):
    url = reverse("edit_article", kwargs={"id": 99})
    # /edit/99/
    return HttpResponse(url)

3. 多分组参数传递

re_path(r"^archive/(\d{4})/(\d{2})/$", views.archive, name="date_archive")

def archive(request, year, month):
    # 反向解析带多个参数
    url = reverse("date_archive", args=(2024, "03"))
    # /archive/2024/03/

六、命名空间解决冲突

1. 应用命名空间

当多个应用存在相同的name时，反向解析会产生冲突。通过命名空间可以区分不同应用的路由：

# 项目主路由
path("cms/", include(("cms.urls", "cms"), namespace="cms")),
path("blog/", include(("blog.urls", "blog"), namespace="blog")),

# 子路由配置
path("index/", views.index_view, name="home")

# 视图中使用
def index_view(request):
    url = reverse("cms:home")  # 使用命名空间:别名
    return HttpResponse(url)

2. 多层命名空间嵌套

path("admin/", include((
    [
        path("users/", include(("users.urls", "users"), namespace="users")),
        path("permissions/", include(("permissions.urls", "permissions"), namespace="permissions")),
    ],
    "admin"
), namespace="admin")),

多层嵌套时，反向解析需要从最外层开始拼接：

reverse("admin:users:list")
reverse("admin:permissions:detail")

总结

Django的路由系统提供了灵活的URL匹配机制，从基础的path函数到支持正则表达式的re_path，再到模块化的include分发和智能的反向解析功能。合理运用命名分组、路由转换器和命名空间，能够构建出结构清晰、易于维护的URL架构。