Django 2.2遇TemplateDoesNotExist错误，求排查与解决

刚接触Django遇到这种模板找不到的问题太正常了，结合你的目录结构和代码，我帮你梳理几个核心排查点，按顺序检查应该就能解决：

1. 确认posts应用已在INSTALLED_APPS中注册 #

Django只会搜索已安装应用下的模板目录，所以第一步必须检查settings.py里的INSTALLED_APPS列表是否包含你的posts应用。你需要添加如下任意一行到列表中：

INSTALLED_APPS = [
    # 其他已有的应用...
    'posts',  # 简洁写法
    # 或者用更规范的AppConfig路径（Django 2.0+推荐）
    # 'posts.apps.PostsConfig',
]

如果没注册这个应用，哪怕你的模板路径完全正确，Django也不会去posts/templates目录下查找模板。

2. 检查TEMPLATES配置中的APP_DIRS是否为True #

打开settings.py找到TEMPLATES配置块，确保APP_DIRS设置为True——这是让Django自动扫描每个已安装应用下templates目录的关键开关：

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],  # 没有全局模板目录的话留空即可
        'APP_DIRS': True,  # 这个必须是True！
        'OPTIONS': {
            # 其他上下文处理器等配置...
        },
    },
]

要是APP_DIRS是False，Django只会去DIRS列表指定的目录找模板，完全不会管应用内的templates文件夹。

3. 验证模板路径和文件名的细节 #

你的目录结构posts/templates/posts/index.html是完全符合Django规范的（用应用名作为子目录避免模板名冲突），视图里的render(req, 'posts/index.html')写法也没问题，但要留意两个小细节：

• 文件名拼写是否精准？比如有没有写成index.htm或者Index.html（Linux/macOS系统下文件名大小写敏感）
• 模板文件是否真的在指定路径里？可以手动打开目录确认，有没有误放到posts/templates根目录而不是posts/templates/posts里。

4. 重启Django开发服务器 #

修改settings.py或者新增模板文件后，记得重启python manage.py runserver——开发服务器会缓存配置，不重启的话新的设置可能不会生效。

如果以上步骤都试过还是报错，可以在TEMPLATES的OPTIONS里开启调试模式，让Django输出所有尝试查找的模板路径，方便精准定位问题：

'OPTIONS': {
    'debug': True,
    'context_processors': [
        # 原有的上下文处理器...
    ],
},

开启后错误页面会列出Django扫描过的所有模板路径，你可以看看有没有包含你的posts/templates/posts/index.html。

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