Django 路由（手把手讲解）

Django 路由：让网站“指哪打哪”的导航系统

在开发一个 Web 应用时，你有没有想过：当用户在浏览器里输入 http://localhost:8000/about/ 时，系统是怎么知道要显示“关于我们”页面的？这个过程，就是由 Django 的核心组件之一——路由系统来完成的。

简单来说，Django 路由就像是一个智能导航地图，它负责接收用户的请求 URL，然后精准地把请求“分发”给对应的视图函数或类。没有它，你的 Django 项目就像一座没有路标的迷宫，用户进得来，却找不到出口。

今天我们就来深入聊聊 Django 路由的底层逻辑、配置方式和实用技巧，帮助你从“会用”走向“精通”。

什么是 Django 路由？它的工作原理

Django 路由的本质，是 URL 模式与视图函数之间的映射关系。你可以把它想象成一个“请求匹配表”：
当用户访问某个地址时，Django 会按照顺序检查路由配置文件中的每一条规则，直到找到匹配的那一条，然后调用对应的视图函数来处理请求。

这个过程可以类比为：

你走进一家餐厅，告诉服务员“我想吃红烧肉”，服务员根据菜单上的菜名（URL 模式）去厨房找对应的厨师（视图函数），然后端上你点的菜（返回响应）。

Django 的路由配置文件位于项目根目录下的 urls.py 文件中，通常会有一个主路由文件和多个子应用的路由文件，形成一个层级结构。

主路由与应用路由：分层管理 URL

在大型项目中，把所有 URL 都写在主 urls.py 里显然不现实。这时候就需要“分而治之”的策略：主路由负责统筹全局，子路由负责管理具体功能模块。

1. 主路由文件（project/urls.py）

from django.contrib import admin
from django.urls import path, include  # include 用于引入子路由

urlpatterns = [
    path('admin/', admin.site.urls),  # 管理后台入口
    path('blog/', include('blog.urls')),  # 把 /blog/ 开头的请求交给 blog 应用处理
    path('shop/', include('shop.urls')),  # /shop/ 开头的请求交给 shop 应用处理
]

注释说明：

• path() 函数定义一条 URL 模式。
• include('blog.urls') 表示将 /blog/ 后面的路径交给 blog/urls.py 文件中的规则去处理。
• 这种“分包”方式让项目结构更清晰，不同功能模块互不干扰。

2. 子应用路由文件（blog/urls.py）

from django.urls import path
from . import views  # 导入当前应用的视图

urlpatterns = [
    path('', views.index, name='blog_index'),           # 访问 /blog/ 时调用 index 视图
    path('post/<int:post_id>/', views.detail, name='post_detail'),  # /blog/post/1/ 会传入 post_id=1
    path('about/', views.about, name='about_page'),
]

注释说明：

• '' 表示空路径，即 /blog/ 的根路径。
• <int:post_id> 是一个路径参数，Django 会自动提取数字并传给视图函数。
• name='blog_index' 是给这条路由起个名字，方便在模板中使用 {% url 'blog_index' %} 生成 URL。

路由参数：从 URL 中提取数据

在实际开发中，你经常需要根据 URL 中的参数来动态加载内容。Django 提供了灵活的路径参数机制，支持多种类型。

常见路径参数类型

实际案例：动态文章详情页

path('post/<int:post_id>/', views.detail, name='post_detail'),

from django.http import HttpResponse
from django.shortcuts import render
from .models import Post  # 假设你有 Post 模型

def detail(request, post_id):
    # Django 自动从 URL 中提取 post_id 并传入函数参数
    try:
        post = Post.objects.get(id=post_id)
        return render(request, 'blog/detail.html', {'post': post})
    except Post.DoesNotExist:
        return HttpResponse("文章不存在", status=404)

注释说明：

• post_id 参数由 Django 路由自动解析并传递给视图函数。
• 使用 get() 查询数据库，若无匹配数据则返回 404 错误。
• render() 函数渲染模板并返回 HTML 响应。

命名路由：让 URL 更易维护

给路由起名字，是 Django 路由中一个非常实用的技巧。命名后的路由可以在模板、视图或代码中通过名字生成完整的 URL，避免硬编码。

为什么命名很重要？

假设你最初把文章详情页的 URL 写成：
<a href="/blog/post/1/">查看文章</a>
但如果将来你把路径改成 /articles/1/，所有硬编码的地方都得改，非常容易出错。

使用 name 参数的好处

path('post/<int:post_id>/', views.detail, name='post_detail'),

在模板中使用：

<!-- 在模板中生成 URL -->
<a href="{% url 'post_detail' post.id %}">查看文章</a>

注释说明：

• {% url 'post_detail' post.id %} 会自动根据路由名字和参数生成正确的 URL。
• 即使你修改了 URL 模式，只要名字不变，模板就不需要改。

正则表达式路由：更强大的匹配能力

虽然 path() 已经能满足大部分需求，但有时你可能需要更复杂的匹配规则。这时可以使用 re_path()，它支持正则表达式。

使用正则表达式匹配复杂路径

from django.urls import re_path
from . import views

urlpatterns = [
    re_path(r'^article/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/$', views.archive, name='archive'),
]

注释说明：

• r'^article/...$' 是 Python 正则表达式语法。
• (?P<year>[0-9]{4}) 表示捕获 4 位数字并命名为 year。
• (?P<month>[0-9]{2}) 捕获两位数字，命名为 month。
• 对应的视图函数：

def archive(request, year, month):
    return HttpResponse(f"您访问了 {year} 年 {month} 月的文章归档")

注意：虽然正则表达式功能强大，但推荐优先使用 path()，因为其语法更清晰、可读性更强。

路由实战：一个完整的博客项目结构

让我们用一个完整示例来总结整个流程：

myproject/
├── manage.py
├── myproject/
│   ├── __init__.py
│   ├── settings.py
│   ├── urls.py           # 主路由
│   └── wsgi.py
├── blog/
│   ├── __init__.py
│   ├── models.py
│   ├── views.py
│   ├── urls.py           # 子路由
│   └── templates/
│       └── blog/
│           ├── index.html
│           └── detail.html

主路由配置（myproject/urls.py）

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('blog/', include('blog.urls')),
]

子路由配置（blog/urls.py）

from django.urls import path
from . import views

urlpatterns = [
    path('', views.index, name='blog_index'),
    path('post/<int:post_id>/', views.detail, name='post_detail'),
    path('about/', views.about, name='about'),
]

视图函数（blog/views.py）

from django.shortcuts import render
from django.http import HttpResponse

def index(request):
    return render(request, 'blog/index.html')

def detail(request, post_id):
    return render(request, 'blog/detail.html', {'post_id': post_id})

def about(request):
    return render(request, 'blog/about.html')

总结：掌握 Django 路由，掌控整个项目入口

Django 路由不仅仅是“URL 到视图”的映射，更是整个 Web 项目结构的“骨架”。它决定了用户如何与你的应用互动，也影响着代码的可维护性和扩展性。

通过今天的讲解，你应该已经掌握了：

• 主路由与子路由的分层设计；
• 路径参数的使用方法；
• 命名路由在模板中的高效应用；
• 正则表达式路由的进阶技巧；
• 一套完整的路由开发实践流程。

记住，一个设计良好的 Django 路由系统，能让你的项目从“能跑”走向“好维护、易扩展”。不要小看这短短几行代码，它可能是你项目成功的关键一步。

当你下次启动 Django 项目，看到 urls.py 文件时，不妨多想一想：

“这条路径，能带用户去往哪个世界？”