Django模板文件找不到求助：无法定位blog/home.html

咱们一步步排查这个模板找不到的问题，下面是几个最常见的出错点和解决办法：

1. 核对模板目录结构是否正确 #

Django的模板查找逻辑默认是每个app的templates目录下，还要对应一个以app名命名的子目录。你的blog应用目录结构应该是这样的：

blog/
├── templates/
│   └── blog/
│       └── home.html  # 必须放在这个子目录里
├── apps.py
├── views.py
...

如果你直接把home.html放在了blog/templates/根目录下，而没建blog子目录，Django肯定找不到blog/home.html这个路径，把文件移到templates/blog/里面就好。

2. 检查settings.py的模板配置是否正确 #

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

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],  # 没有全局模板目录就保持空
        'APP_DIRS': True,  # 这个必须是True
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

要是APP_DIRS是False，Django就不会去app的templates目录找模板，改回True就行。

3. 确认视图里的模板调用路径正确 #

你在blog/views.py里渲染模板的代码，是不是写的return render(request, 'blog/home.html')？如果写错成'home.html'或者其他路径，也会报错。正确写法示例：

from django.shortcuts import render

def home(request):
    # 必须指定完整的app模板路径
    return render(request, 'blog/home.html')

如果只写'home.html'，Django会去全局模板目录找，而不是blog/templates/blog/下面。

4. 验证INSTALLED_APPS的app配置 #

你已经把blog.apps.BlogConfig加到INSTALLED_APPS里了，这部分没问题，但可以再确认下blog/apps.py的内容是否正确：

from django.apps import AppConfig

class BlogConfig(AppConfig):
    name = 'blog'  # 必须和你的app目录名一致

确保name字段是'blog'，和你的应用目录名称匹配。

5. 清理缓存并重启服务器 #

有时候Django会缓存旧的模板路径，修改目录或配置后没立即生效。先关掉当前的服务器进程，再重新运行python manage.py runserver。也可以试试运行python manage.py check，让Django帮你检查配置有没有语法或逻辑错误。

按照上面的步骤排查，大概率能解决模板找不到的问题。

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