Django URLconf路由配置详解与实战

宋时安
宋时安
发布时间:2026-10-13| 5人浏览过
原创

本文深入解析Django URLconf路由系统的核心机制,涵盖正则表达式匹配原理、视图函数参数传递方式及关键字参数配置。通过具体示例演示URL命名、路由分发及include方法的应用,帮助开发者构建灵活且高性能的Django网站路由结构。

URLconf是什么?

URL配置(URLconf)在Django中扮演着网站目录的角色。其核心本质是建立URL地址与对应view函数之间的映射关系表。通过这种配置,开发者明确指示Django:当请求特定URL时,应执行哪段代码;请求另一URL时,又应调用哪段逻辑。

urlpatterns = [
   url(正则表达式, views视图函数,参数,别名),
   re_path(正则表达式, views视图函数,参数,别名), (在2.0以上版本中使用re_path),
]

参数说明:

正则表达式(regex):

regex是正则表达式的通用缩写,它是一种用于匹配字符串或URL地址的语法规范。Django接收用户请求的URL后,会在urls.py文件中的urlpatterns列表里,从头开始逐项与正则表达式进行比对。一旦找到匹配项,立即执行该条目映射的视图函数或二级路由,后续条目将不再参与匹配。因此,URL路由的编写顺序至关重要。需注意,regex仅匹配URL路径部分,不包含GET或POST参数,也不包含域名。例如,对于https://www.example.com/myapp/,regex仅尝试匹配myapp/;对于https://www.example.com/myapp/?page=3,regex同样只匹配myapp/。若需深入理解正则表达式,建议阅读相关书籍或专论,但在Django的实际开发中,通常无需掌握高深的正则知识。

性能注释:正则表达式在URLconf模块加载时会被预先编译,因此匹配搜索速度极快,开发者通常感知不到延迟。

view视图函数:

当正则表达式成功匹配某个条目时,Django会自动将封装好的HttpRequest对象作为第一个参数传递给该条目指定的视图函数。正则表达式中“捕获”到的值将作为第二个参数传入:若是简单捕获,捕获值以位置参数形式传递;若是命名捕获,则以关键字参数形式传递。

参数(kwargs):

可以传递任意数量的关键字参数,这些参数以字典形式传递给目标视图函数。

别名(name):

为URL设置名称,使得在Django的任何地方,特别是在模板中,能够显式地引用该URL。这相当于为URL分配了一个全局变量名,从而避免了高昂的维护成本。

 

示例:

例如服务器IP地址为127.0.0.1:8080

urlpatterns = [
  path('admin/', admin.site.urls),
  re_path(r'^$', views.index),      # 当用户访问 http://127.0.0.1:8080 时,后端用view.py中的index()函数处理。$表示结尾
  re_path(r"^host/(\d+)",views.host),  # URL示例:127.0.0.1:8080/host/100 \d代表数字;()表示无名分组且可以传参,函数内参数和次顺序一一对应;
      # +表示重复一次或多次前面类型的字符。(\d+)表示不定位数的数字
  re_path(r'^host_list/(\d{4})/(\d{2})$', views.host_list), # URL示例: 127.0.0.1:8080/host_list/2015/10  {4}表示重复四次前面的数字
  url(r"^register",views.register,name="reg"),  # 127.0.0.1:8080/register reg是URL别名,在模板中,例如<a href="{% url 'reg' %}" rel="external nofollow" ></a>
  re_path(r"^login",views.login,name="log"),  # 127.0.0.1:8080/login
  re_path(r'^article/(?P<year>\d{4})/(?P<month>\d{2})/(?P<day>\d{2})',views.article_month), # 127.0.0.1:8080/article/2015/09/10 ?P表示有名分组,
      # ()内是分组,<>内是组名函数内参数名必须和组名相同,顺序可以乱。
]

路由分发

如果一个项目下包含多个app,那么在urls.py中就需要编写大量的URL映射关系。这种方式不仅显得不够灵活,而且代码杂乱无章。

我们可以根据不同的app来分类处理不同的URL请求。

首先,在urls.py中写入URL映射条目。注意需要导入include方法。

url(r'^app1/',include("app01.urls")), # 路由分发,所有app1开头的,全部转移到app01下的urls.py里去处理

需要在app01目录下创建一个urls.py文件,用于处理请求的URL,并建立与views的映射关系。

urlpatterns = [
  re_path(r'index/$', views.index), # 127.0.0.1:8080/app1/index
]

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持本站。

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。