Django拆分settings为多文件后报错TemplateDoesNotExist找不到index.html如何解决

问题根因 #

你遇到的报错本质是拆分settings目录后，BASE_DIR的相对路径计算错误，导致Django找不到模板目录。
原来的默认BASE_DIR定义是基于单文件settings.py的位置计算的：

# 原单settings文件时的BASE_DIR定义
BASE_DIR = Path(__file__).resolve().parent.parent

拆分settings为子文件夹后，base.py的路径从项目名/项目名/settings.py变成了项目名/项目名/settings/base.py，原来的两层父目录计算得到的路径变成了项目名/项目名，而非真正的项目根目录，因此BASE_DIR / "templates"指向的路径和你实际存放模板的路径不一致。

修复步骤 #

1. 修正base.py中的BASE_DIR定义，多计算一层父目录：

BASE_DIR = Path(__file__).resolve().parent.parent.parent

2. 确认TEMPLATES配置中的DIRS参数保持正确写法：

TEMPLATES = [
    {
        # 其余配置保持不变
        'DIRS': [(BASE_DIR / "templates")],
        # 其余配置保持不变
    },
]

3. 可选验证：你可以在base.py中临时添加打印代码，启动开发服务器时确认输出的路径为项目根目录：

print("当前BASE_DIR路径：", BASE_DIR)

4. 重启Django开发服务器，再次访问页面验证模板是否正常加载。

如果你的模板是存放在对应App的templates目录下，额外确认对应App已经添加到INSTALLED_APPS列表中即可。

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