Django无法识别index.html页面，始终显示默认安装成功页

以下是几个需要排查的关键点：

1. 确认项目根URL配置是否正确 #

如果你的urls.py是应用级的配置文件，必须在项目根目录的urls.py中添加对应用urls的引用，否则根路径/不会匹配到你的视图。

项目根urls.py正确配置示例：

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

urlpatterns = [
    path('', include('你的应用名.urls')),  # 替换为你的实际应用名称
    path('admin/', admin.site.urls),
]

如果你的urls.py本身就是项目根的配置文件，继续往下排查。

2. 检查模板文件位置与配置 #

• 确保index.html放在正确目录：
  • 方式一：在应用目录下创建templates文件夹，将index.html放入其中（需确保应用已添加到INSTALLED_APPS）。
  • 方式二：在项目根目录创建templates文件夹，然后在settings.py的TEMPLATES配置中，将DIRS设置为[BASE_DIR / 'templates']。
• 确认settings.py中INSTALLED_APPS已添加你的应用名称，示例：

  INSTALLED_APPS = [
      'django.contrib.admin',
      'django.contrib.auth',
      'django.contrib.contenttypes',
      'django.contrib.sessions',
      'django.contrib.messages',
      'django.contrib.staticfiles',
      '你的应用名',  # 必须添加此行
  ]
  

3. 修复模板语法错误 #

你的index.html中<p>标签未正确闭合，将<p>index</>修改为<p>index</p>，避免模板渲染异常。

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

浏览器可能缓存了旧的默认页面，尝试清除缓存后重新访问，或直接用无痕窗口打开http://127.0.0.1:8000/。

5. 重启Django开发服务器 #

修改配置后必须重启开发服务器，否则新配置不会生效。

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