目录
1. 什么是 Django 路由？
Django 路由系统（也叫 URL 路由）负责将 URL 请求映射到相应的视图函数。每当用户访问某个 URL，Django 会根据 URL 模式查找对应的视图，然后执行该视图的逻辑并返回响应。
路由系统是 Django 的核心部分，它将 Web 请求与后端视图函数关联起来。
2. 配置 Django 路由
Django 中的 URL 路由配置通常放在 urls.py 文件中。这个文件指定了应用中的视图与 URL 模式之间的映射关系。
2.1 配置应用级 URL
每个 Django 应用都有一个 urls.py 文件。在应用的 urls.py 文件中，您定义 URL 路由模式并关联到相应的视图函数。
例如，创建一个应用并配置其 URL 路由：
# myapp/urls.py
from django.urls import path
from . import views
urlpatterns = [
path('', views.index, name='index'), # 根路径
path('about/', views.about, name='about'), # 关于页
]
2.2 配置主项目级 URL
在项目的 urls.py 文件中，通常会包含应用的路由配置。例如：
# project/urls.py
from django.contrib import admin
from django.urls import path, include
urlpatterns = [
path('admin/', admin.site.urls),
path('myapp/', include('myapp.urls')), # 包含 myapp 应用的 URL 路由
]
这样，访问 http://localhost/myapp/ 时会匹配到 myapp/urls.py 中的路由配置。
3. URL 路由与视图
Django 路由的核心就是将 URL 映射到视图函数。视图函数处理请求，并生成响应。视图可以是普通函数或基于类的视图。
3.1 基于函数的视图 (FBV)
例如，创建一个视图函数来处理根路径请求：
# myapp/views.py
from django.http import HttpResponse
def index(request):
return HttpResponse("欢迎访问首页！")
在 urls.py 中配置该视图与 URL 路由：
# myapp/urls.py
from django.urls import path
from . import views
urlpatterns = [
path('', views.index, name='index'),
]
3.2 基于类的视图 (CBV)
也可以使用类视图来处理请求。Django 提供了许多内置的基于类的视图，能够帮助我们快速实现常见功能。
例如，创建一个显示欢迎信息的视图：
# myapp/views.py
from django.http import HttpResponse
from django.views import View
class IndexView(View):
def get(self, request):
return HttpResponse("欢迎访问首页！")
在 urls.py 中配置该类视图与 URL 路由：
# myapp/urls.py
from django.urls import path
from .views import IndexView
urlpatterns = [
path('', IndexView.as_view(), name='index'),
]
4. 路由参数
Django 允许在 URL 路由中使用参数。URL 参数可以是任何字符串、整数、日期等类型。您可以在视图中通过参数来处理不同的请求。
4.1 捕获参数
例如，创建一个视图来处理动态 URL 参数：
# myapp/views.py
from django.http import HttpResponse
def greet_user(request, username):
return HttpResponse(f"Hello, {username}!")
在 urls.py 中配置该视图并捕获 URL 中的 username 参数：
# myapp/urls.py
from django.urls import path
from . import views
urlpatterns = [
path('greet/<str:username>/', views.greet_user, name='greet_user'),
]
这里，<str:username> 会捕获 URL 中的字符串参数 username，并传递给视图函数。
4.2 使用其他类型的路由参数
Django 还支持多种类型的路由参数，例如：
<int:id>/：匹配整数。<slug:slug>/：匹配包含字母、数字、破折号等字符的字符串。
例如，创建一个处理文章 ID 的视图：
# myapp/views.py
from django.http import HttpResponse
def article_detail(request, article_id):
return HttpResponse(f"显示文章 ID：{article_id}")
在 urls.py 中配置该视图并捕获整数类型的 article_id 参数：
# myapp/urls.py
from django.urls import path
from . import views
urlpatterns = [
path('article/<int:article_id>/', views.article_detail, name='article_detail'),
]
5. 命名 URL
为 URL 配置命名能够提高可维护性，使得在模板中反向解析 URL 更加方便。
5.1 给 URL 配置名称
在 urls.py 中使用 name 参数为每个 URL 配置一个名称：
# myapp/urls.py
from django.urls import path
from . import views
urlpatterns = [
path('', views.index, name='home'),
path('greet/<str:username>/', views.greet_user, name='greet_user'),
]
5.2 使用命名 URL 反向解析
在模板中使用 {% url %} 标签反向解析 URL：
<!-- home.html -->
<a href="{% url 'greet_user' username='John' %}">欢迎 John</a>
在视图中，使用 reverse 函数来生成 URL：
from django.urls import reverse
from django.http import HttpResponse
def redirect_view(request):
url = reverse('greet_user', kwargs={'username': 'John'})
return HttpResponse(f'重定向到: {url}')
6. URL 反向解析
反向解析 URL 是 Django 提供的一个强大功能，它允许通过 URL 名称生成对应的 URL。
6.1 使用 reverse 反向解析 URL
在视图中，你可以通过 reverse() 函数获取 URL：
from django.urls import reverse
from django.http import HttpResponseRedirect
def redirect_view(request):
url = reverse('greet_user', kwargs={'username': 'John'})
return HttpResponseRedirect(url)
reverse 会根据 URL 配置的名称和传递的参数生成正确的 URL。
7. 路由包括静态文件
Django 默认通过 django.conf.urls.static 提供静态文件的路由。如果开发模式下需要访问静态文件（如 CSS、JS 或图片），您需要在 urls.py 中包括静态文件路由。
7.1 配置静态文件路由
在 urls.py 中配置静态文件的路由：
# project/urls.py
from django.conf import settings
from django.conf.urls.static import static
from django.urls import path, include
urlpatterns = [
path('admin/', admin.site.urls),
path('myapp/', include('myapp.urls')),
]
if settings.DEBUG:
urlpatterns += static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
这将使得在开发模式下，Django 能够正确地提供静态文件。
8. 常见问题与解决方案
1. URL 路由不匹配
- 检查 URL 路由模式是否与请求的路径匹配。确保路径中的参数名称和类型与视图函数中的参数一致。
2. 参数类型错误
- 在路由中，确保传递的参数类型与视图函数中的参数类型匹配。例如，
<int:id>应该传递整数。
3. 反向解析无法生成 URL
- 确保在
urls.py中为每个路由配置了唯一的name，并且reverse()使用的名称与配置一致。
发表回复