Django模板中url标签的高级用法详解

Elena

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

原创

本文详细解析Django模板中url标签的多种使用场景，包括基础URL反转、位置参数与关键字参数的传递规则、查询字符串的手动拼接以及多参数组合方式。通过代码示例展示如何在HTML模板中动态生成链接，避免硬编码，提升代码可维护性。

Django模板中url标签基础用法

在Web开发中，模板内经常需要生成页面跳转链接，例如为<a>标签设置href属性。虽然可以直接硬编码URL字符串，但这会增加后期维护成本。推荐采用动态方式生成URL，类似于Django中的reverse()函数机制，以实现视图与模板的解耦。具体实现参考以下代码片段：


 <li><a href="/">首页</a></li>
{# 此时采用动态获取url的方式，使用url标签可以在DTL模板中动态获取url,#}
{# 而使用reverse()函数，可以在Django中动态获取url标签，将视图函数进行反转，得到url. #}
 <li><a href="{% url 'book' %}">读书</a></li>
 <li><a href="{% url 'movie' %}">电影</a></li>
 <li><a href="{% url 'city' %}">同城</a></li>

URL反转中的参数传递规则

当进行URL反转并需要传递参数时，支持位置参数和关键字参数两种形式，但二者不可混用。位置参数按顺序匹配URL路径中的变量，而关键字参数通过键值对指定。示例代码如下：


{# url反转，使用位置参数，但是关键字参数和位置参数不能同时使用 #}
 <li><a href="{% url 'detal' 1 %}"></a></li>
 
{# url反转，使用关键字参数 #}
{# 接收url中传递参数，可以在url中直接传递参数，并且指定参数的值，但是此时=两边不能有空格，否者的话，不能识别 #}
 <li><a href="{% url 'detail' book_id='3' %}">最火的一篇文章详情</a></li>

查询字符串的手动拼接方法

若需在URL反转后附加查询字符串（Query String），必须手动在模板中拼接，因为url标签本身不直接支持查询参数的自动处理。例如实现登录成功后重定向到首页的功能，示例代码如下：


{# 在模板中使用查询字符串的形式添加参数，此时就只能和reverse()函数一样，只能手动的添加，使url进行拼接。 #}
{# 实现登录成功之后跳转到首页 #}
 <li><a href="{% url 'login' %}?next=/">登录</a></li>

多参数组合传递技巧

当需要传递多个参数时，可以在url标签中通过空格分隔多个键值对或位置参数。这种方式适用于URL路径中包含多个动态变量的场景。示例代码如下：


<li><a href="{% url 'detail' book_id='3' author='小蚂蚁' %}">最火的一篇文章详情</a></li>

完整视图与模板实现示例

以下是完整的后端视图实现代码，展示了如何定义各个视图函数以支持上述URL反转操作：

views.py文件中的视图逻辑如下，定义了首页、图书、电影、同城、详情及登录等视图函数，其中book_detail视图接收book_id和author两个参数：


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


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


# 定义登录视图函数
def login(request):
 next = request.GET.get('next')
 text = "登录完成后，要跳转的页面是：%s" % next
 return HttpResponse(text)


def book(request):
 return HttpResponse('图书页面')


# 在进行访问url的时候进行传递参数视图，直接传入一个参数
def book_detail(request,book_id,author):
 text = '您输入的图书id是：%s,作者是：%s' % (book_id,author)
 return HttpResponse(text)


def movie(request):
 return HttpResponse('电影页面')


def city(request):
 return HttpResponse("同城页面")

index.html模板文件代码如下，展示了如何在HTML中使用url标签动态生成导航链接，包括基础链接、带参数链接及查询字符串拼接：


<!DOCTYPE html>
<html lang="en">
<head>
 <meta charset="UTF-8">
 <title>Title</title>
 <style>
  .nav {
   overflow: hidden;
  }
  .nav li {
   float: left;
  {# 将li标签前面的圆点去掉 #}
   list-style: none;
   {# 定义li标签之间的外边距，上下为0，左右为20px #}
   margin: 0 20px;
  }
 </style>
</head>
<body>
<ul class="nav">
 <li><a href="/">首页</a></li>
{# 此时采用动态获取url的方式，使用url标签可以在DTL模板中动态获取url,#}
{# 而使用reverse()函数，可以在Django中动态获取url标签，将视图函数进行反转，得到url. #}
 <li><a href="{% url 'book' %}">读书</a></li>
 <li><a href="{% url 'movie' %}">电影</a></li>
 <li><a href="{% url 'city' %}">同城</a></li>
{# url反转，使用位置参数，但是关键字参数和位置参数不能同时使用 #}
{# <li><a href="{% url 'detal' 1 %}"></a></li>#}
{# url反转，使用关键字参数 #}
{# 接收url中传递参数，可以在url中直接传递参数，并且指定参数的值，但是此时=两边不能有空格，否者的话，不能识别 #}
 <li><a href="{% url 'detail' book_id='3' author="小蚂蚁" %}">最火的一篇文章详情</a></li>
{# 在模板中使用查询字符串的形式添加参数，此时就只能和reverse()函数一样，只能手动的添加，使url进行拼接。 #}
{# 实现登录成功之后跳转到首页 #}
 <li><a href="{% url 'login' %}?next=/">登录</a></li>
</ul>
</body>
</html>

视图函数与URL路径的映射配置在urls.py中，通过path()函数定义路由规则，并指定name属性以供模板反转使用。具体配置如下：


from django.urls import path
from . import views

urlpatterns = [
 path('',views.index,name = 'index'),
 path('book/',views.book,name = 'book'),
 path('movie/',views.movie,name = 'movie'),
 path('city/',views.city,name = 'city'),
 path('book/detail/<book_id>/<author>/',views.book_detail,name = 'detail'),
 path('login/',views.login,name = 'login'),

]

在浏览器中访问对应URL，验证页面跳转及参数传递结果是否符合预期。