详解Django使用include无法跳转的解决方法

栗子

发布时间：2026-10-13| 5人浏览过

原创

本文介绍Django项目中利用include分发URL时常见的跳转失败问题。核心原因往往在于根URL配置中视图函数的位置不当，导致路由匹配优先级冲突。通过调整urlpatterns列表顺序，将通用视图置于include之后，即可解决无法跳转的问题。

Django项目URL分发结构

在构建Django项目时，通常推荐采用特定的目录结构，并通过include机制将URL分发至各个应用（apps）内部的urls.py文件中，以实现模块化管理。

具体配置示例如下所示：


-projtect
---apps
-----user
-------urls.py
-urls.py

常见跳转失败原因

然而，在实际操作中可能会发现页面无法正确跳转，经排查，问题往往出在根URL配置文件的写法上。

错误与正确配置对比

以下是一种错误的配置方式示例：


urlpatterns = [
  url(r'^admin/', admin.site.urls),
  url(r'^', views.Index.as_view(), name='index'),
  url(r'^user/', include('apps.user.urls',namespace='user')),
]
urlpatterns += staticfiles_urlpatterns()

正确的做法主要涉及调整url(r'^', views.Index.as_view(), name='index')这一行代码在urlpatterns列表中的位置。

只需将该行代码移至列表的最底部即可解决问题。


urlpatterns = [
  url(r'^admin/', admin.site.urls),
  url(r'^user/', include('apps.user.urls',namespace='user')),
  url(r'^', views.Index.as_view(), name='index'),
]
urlpatterns += staticfiles_urlpatterns()

至此，关于Django使用include无法跳转的解决方法介绍完毕。如需了解更多相关Django include路由配置内容，建议查阅本站历史文章或继续浏览后续教程，感谢支持。