Django访问根路径报TemplateDoesNotExist错误 找不到main/index.html模板

问题原因排查及解决方法 #

1. 检查模板目录结构是否符合要求 #

你已开启APP_DIRS = True配置，Django会自动从每个已注册应用的templates目录下查找模板，正确的目录结构要求如下：

项目根目录（和manage.py同级）
├── main/
│   ├── templates/          # main应用下新建templates目录
│   │   └── main/           # 必须再建一层和应用同名的子目录，避免不同应用模板重名冲突
│   │       └── index.html  # 你的页面模板文件
│   ├── views.py
│   ├── urls.py
│   └── 其他应用文件
├── taskmanager/
└── manage.py

如果你是把templates目录放在项目根目录（和main、taskmanager文件夹同级），则需要修改settings.py中TEMPLATES配置的DIRS字段，手动指定模板查找路径：

TEMPLATES = [
    {
        ...
        'DIRS': [BASE_DIR / 'templates'],  # 新增本行配置
        'APP_DIRS': True,
        ...
    },
]

2. 修正settings.py中的错误配置 #

当前TEMPLATES的context_processors列表内存在非法项'main'，上下文处理器必须是可调用的函数路径，不可以直接填写应用名，直接删除该条目即可：

'context_processors': [
    'django.template.context_processors.debug',
    'django.template.context_processors.request',
    'django.contrib.auth.context_processors.auth',
    'django.contrib.messages.context_processors.messages',
    # 移除原有的'main'配置行
],

该错误配置会直接干扰Django的模板加载逻辑。

3. 检查模板文件本身属性 #

确认模板文件后缀确实为.html，没有隐藏后缀（比如Windows默认隐藏已知后缀名的场景下，可能实际文件名为index.html.txt）。

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