Django URL 命名空間錯誤解決指南
更新日期： 2024 年 11 月 28 日
在使用 Django 時，初學者常會遇到「NoReverseMatch at / ‘app_name’ is not a registered namespace」的錯誤。
這篇文章將幫助您，理解命名空間（namespace）的使用原理，並提供清晰的解決方案。
問題描述
以下是一個出現錯誤的範例程式碼：
urls.py
from django.contrib import admin
from django.urls import path
from . import views
app_name = 'blog'
urlpatterns = [
path('admin/', admin.site.urls),
path('', views.index, name='index'),
path('about/', views.about, name='about'),
]
HTML 模板
<h1>首頁</h1>
<ul>
<li><a href="{% url 'blog:about' %}">關於我</a></li>
</ul>
錯誤訊息
NoReverseMatch at /<br>'blog' is not a registered namespace問題原因
此問題通常是因為 命名空間未正確設置 所導致。
以下為可能的原因：
- 應用程式的 URL 配置未與主專案通過
include()正確連接
Django 的命名空間，需要在應用程式自己的urls.py文件中定義，並在主專案的urls.py中以include()的方式引入。 - 應用程式未正確註冊到
INSTALLED_APPS中
如果應用程式未包含在INSTALLED_APPS中，Django 將無法識別並載入該應用程式。
解決方案
為應用程式創建獨立的 urls.py 文件
確保每個應用程式擁有自己的 URL 配置文件。
例如，對於 blog 應用，建立以下 blog/urls.py 文件：
# blog/urls.py
from django.urls import path
from . import views
app_name = 'blog' # 定義命名空間
urlpatterns = [
path('', views.index, name='index'),
path('about/', views.about, name='about'),
]
在主專案中使用 include() 引入應用程式的路由
修改主專案的 urls.py，通過 include() 將應用程式的路由配置導入：
# mysite/urls.py
from django.contrib import admin
from django.urls import path, include
urlpatterns = [
path('admin/', admin.site.urls),
path('', include('blog.urls')), # 引入 blog 應用的 URL 配置
]
確認應用程式已添加至 INSTALLED_APPS
確保您的應用程式在 settings.py 中被註冊：
# settings.py
INSTALLED_APPS = [
# 其他應用程式
'blog', # 確保此處添加了 blog 應用程式
]
重啟伺服器以應用更改
每次修改配置後，請重啟開發伺服器：
python manage.py runserver注意事項
- 模板中的命名空間格式
使用{% url 'app_name:view_name' %}時，app_name必須與urls.py中的app_name保持一致。例如：<li><a href="{% url 'blog:about' %}">關於我</a></li> - 檢查文件結構與路徑
確保應用程式的文件結構清晰，例如：
mysite/
├── blog/
│ ├── urls.py
│ ├── views.py
│ └── templates/
├── mysite/
│ ├── urls.py
│ └── settings.py
- 避免拼寫錯誤
像app_name、view_name以及 URL 名稱需小心檢查拼寫錯誤。
總結
在 Django 中，app_name 是命名空間功能的核心配置，但它的正確使用依賴於以下條件：
- 應用程式有自己的
urls.py文件，並定義app_name。 - 主專案通過
include()將應用程式的路由配置引入。 - 應用程式需在
INSTALLED_APPS中註冊。 - 模板中的 URL 使用需符合命名空間格式。
按照上述步驟進行配置，您就能成功解決 NoReverseMatch 錯誤，讓開發更加順利！