为何Django中使用{% url %}标签无法跳转至用户Profile页面？

报错信息 #

Reverse for 'profile/{{user.username}}' not found. 'profile/{{user.username}}' is not a valid view function or pattern name

模板代码 #

{% if user.is_authenticated %}
        <li><a href="{% url 'home' %}">Home</a></li>
        <li><a href="{% url 'profile/{{user.username}}' %}">Profile</a></li>
        <li><a href="{% url 'settings' %}">Settings</a></li>
        <li><a href="{% url 'logout' %}">Logout</a></li>
{% endif %}

项目URL配置 #

urlpatterns = [
    path('', views.index, name='index'),
    path('home', views.home, name='home'),
    path('likes', views.likes, name='likes'),
    path('login', views.login, name='login'),
    path('follow', views.follow, name='follow'),
    path('search', views.search, name='search'),
    path('about', views.aboutus, name='about'),
    path('signup', views.signup, name='signup'),
    path('upload', views.upload, name='upload'),
    path('logout', views.logout, name='logout'),
    path('settings', views.settings, name='settings'),
    path('profile/<str:pf>', views.profile, name='profile'),
]

问题场景 #

使用{% url 'profile/{{user.username}}' %}无法跳转至用户个人资料页面，但直接写硬编码路径/profile/{{user.username}}可以正常跳转，想明确其中原因。

原因及解决方案 #

错误根源 #

你误解了{% url %}标签的用法。这个标签的核心作用是通过URL配置里的name反向生成路径，而非直接拼接字符串。

你写的{% url 'profile/{{user.username}}' %}相当于让Django去查找一个名为profile/{{user.username}}的URL模式，但你的URL配置里只有名为profile的模式，且该模式需要接收一个pf参数。Django找不到匹配的模式，因此抛出反向解析失败的错误。

正确写法 #

对于带参数的URL模式，{% url %}标签的正确格式是：先指定URL的name，再传入参数值。针对你的场景，正确代码如下：

<li><a href="{% url 'profile' user.username %}">Profile</a></li>

这里'profile'对应URL配置中的name='profile'，user.username会被自动传入路径参数pf，Django会帮你生成正确的/profile/xxx路径。

硬编码路径生效的原因 #

直接写/profile/{{user.username}}是手动拼接URL路径，绕过了Django的反向解析机制，刚好匹配到profile/<str:pf>的路径规则，所以能正常跳转。但这种写法不推荐——如果后续修改URL路径（比如把profile改成user-profile），所有硬编码的地方都要手动修改，而使用{% url %}标签的话，只需修改URL配置中的路径，所有引用处会自动更新，维护成本更低。

内容的提问来源于stack exchange，提问作者Sahil Singhai