Django新手求助：运行runserver后无法加载自定义首页

以下是几个排查和解决的关键点：

1. 确认accounts应用已添加到项目配置 #

打开项目根目录下的settings.py，找到INSTALLED_APPS列表，确保'accounts'已经添加进去：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    # 必须添加这一行
    'accounts',
]

2. 检查HomePage视图的实现 #

你使用的是类视图HomePage.as_view()，需要确保视图正确指定了模板文件：

• 如果视图写在项目根目录的views.py里，代码应该是：

from django.views.generic import TemplateView

class HomePage(TemplateView):
    # 明确指向你的index.html文件
    template_name = 'index.html'

• 如果视图写在accounts应用的views.py里，项目根的urls.py需要通过include引入应用的路由，而不是直接导入根目录视图：
  项目根urls.py修改为：

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

urlpatterns = [
    path('', include('accounts.urls')),
    path("admin/", admin.site.urls),
]

然后在accounts目录下新建urls.py，内容：

from django.urls import path
from .views import HomePage

urlpatterns = [
    path('', HomePage.as_view(), name='home'),
]

3. 确认模板文件位置正确 #

Django默认会查找每个应用下的templates文件夹，所以你需要在accounts目录下创建templates文件夹，将index.html放在accounts/templates/index.html路径下。

如果模板放在项目根目录的templates文件夹中，需要在settings.py的TEMPLATES配置里添加目录路径：

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [BASE_DIR / 'templates'],  # 添加这一行
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

4. 清除浏览器缓存或使用无痕模式 #

浏览器缓存可能导致旧页面无法更新，按Ctrl+Shift+R强制刷新页面，或者打开无痕窗口访问http://127.0.0.1:8000。

5. 确认在正确目录运行runserver #

必须在包含manage.py的项目根目录执行启动命令：

python manage.py runserver

如果目录错误，Django会加载默认配置而非你的项目设置。

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