如何修改Django投票项目，为域名根路径添加自定义主页？

一、为什么polls里的空路径对应/polls/？ #

不是因为app_name = "polls"命名空间，核心原因是主urls.py里的path("polls/", include("polls.urls"))：当使用include时，Django会把主路径里的前缀（这里是polls/）和子urls.py里的路径拼接。所以polls/urls.py里的path("", views.index)就会被解析为polls/，和命名空间无关——命名空间的作用是反向解析URL时区分不同app里同名的url名称，不影响路径的拼接规则。

二、设置根路径（domainname.com/）自定义主页的方案 #

方案1：直接在主应用（mysite）中实现 #

1. 在mysite/views.py中编写主页视图：

from django.shortcuts import render

def home(request):
    # 编写主页逻辑，比如渲染模板
    return render(request, 'home.html')

2. 修改mysite/urls.py，把根路径指向这个视图：

from django.contrib import admin
from django.urls import include, path

from . import views

urlpatterns = [
    path('admin/', admin.site.urls),
    path("polls/", include("polls.urls")),
    # 根路径映射到主页视图
    path('', views.home, name="home"),
]

3. 在mysite/templates/下创建home.html模板文件（记得在settings.py里确保'DIRS': [BASE_DIR / 'templates']配置正确）。

方案2：将主页挂载到现有polls app（仅适用于想把polls首页当主页的场景） #

如果希望根路径直接显示polls的列表页，修改主urls.py，添加根路径指向polls的index视图：

from django.contrib import admin
from django.urls import include, path
# 导入polls的视图
from polls import views as polls_views

urlpatterns = [
    path('admin/', admin.site.urls),
    path("polls/", include("polls.urls")),
    # 根路径指向polls的index视图
    path('', polls_views.index, name="home"),
]

方案3：新建独立的home/frontpage app（推荐用于有扩展需求的场景） #

1. 创建新app：

python manage.py startapp home

2. 在home/views.py中编写主页视图：

from django.shortcuts import render

def home(request):
    return render(request, 'home/home.html')

3. 创建home/urls.py并配置路径：

from django.urls import path
from . import views

# 可以设置命名空间
app_name = "home"

urlpatterns = [
    path('', views.home, name="home"),
]

4. 修改主mysite/urls.py，将根路径指向这个新app的urls：

from django.contrib import admin
from django.urls import include, path

urlpatterns = [
    path('admin/', admin.site.urls),
    path("polls/", include("polls.urls")),
    # 根路径挂载home app的urls
    path('', include("home.urls")),
]

5. 在home/templates/home/下创建home.html模板，同时把home app添加到settings.py的INSTALLED_APPS中。

补充疑问解答 #

疑问1：只为一个页面建app是否合理，是行业惯例吗？ #

• 小项目/简单场景：完全没必要，直接在主应用写视图更简洁。
• 中大型项目/有扩展预期：非常合理，也是行业常见做法。Django的核心思想是模块化拆分，哪怕现在主页只有一个页面，未来可能要加轮播、新闻板块、用户入口等功能，单独的app能让代码结构更清晰，便于维护和迭代。

疑问2：承载主页的应用是否不能设置命名空间？ #

完全可以设置app_name，命名空间和路径挂载没有冲突。比如上面方案3中home app设置了app_name = "home"，反向解析URL时可以用{% url 'home:home' %}，不会影响根路径的映射。命名空间的作用只是避免不同app中同名url的混淆，和URL的路径前缀无关。

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