Django项目中模板文件夹下App子目录HTML文件无法渲染求助

问题核心 #

将index.html从项目根目录的templates文件夹移至templates/students子文件夹后无法渲染，已确认文件路径和HTML内容无误。

排查与解决步骤 #

1. 检查INSTALLED_APPS配置 #

这是最常见的问题根源：Django只会查找已注册应用下的templates目录。打开项目根目录的settings.py，确保students应用已加入INSTALLED_APPS列表：

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

2. 确认目录结构正确性 #

确保模板目录层级完全符合要求：

你的项目/
├── templates/
│   └── students/
│       └── index.html
├── students/
│   ├── urls.py
│   ├── views.py
│   └── apps.py  # 应用默认配置文件，需存在
└── settings.py

3. 验证视图中的模板路径 #

你在views.py中编写的模板路径'students/index.html'格式正确，无需修改：

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

总结 #

完成上述配置后，重启Django开发服务器，页面即可正常渲染。

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