Django无法识别全局templates文件夹中base.html的问题求助

问题场景 #

• 项目名：my_blog，应用名：blog
• 已将blog加入INSTALLED_APPS，配置了BASE_DIR/templates作为模板路径
• 项目根目录的templates文件夹下存放了base.html，但index.html中使用{%extends 'base.html'%}进行模板继承时，触发TemplateDoesNotExist错误

用户尝试过的修改 #

原视图代码：

def homepage(request):
   return render(request,"blog/index.html")

修改尝试1：

def homepage(request):
   return render(request,"templates/blog/index.html")

修改尝试2：

def homepage(request):
   return render(request,"index.html")

以上修改均未解决问题，报错信息如下：

TemplateDoesNotExist at /
base.html
请求方法：GET
请求URL：http://127.0.0.1:8000/
Django版本：4.2
异常类型：TemplateDoesNotExist
异常值：base.html
异常位置：C:\Users\27388808\AppData\Local\Programs\Python\Python311\Lib\site-packages\django\template\backends\django.py, line 84, in reraise
触发位置：blog.views.start_page
Python可执行文件：C:\Users\27388808\AppData\Local\Programs\Python\Python311\python.exe
Python版本：3.11.2
Python路径：
['C:\Users\27388808\chantellblog',
'C:\Users\27388808\AppData\Local\Programs\Python\Python311\python311.zip',
'C:\Users\27388808\AppData\Local\Programs\Python\Python311\DLLs',
'C:\Users\27388808\AppData\Local\Programs\Python\Python311\Lib',
'C:\Users\27388808\AppData\Local\Programs\Python\Python311',
'C:\Users\27388808\AppData\Local\Programs\Python\Python311\Lib']

排查与解决步骤 #

1. 确认TEMPLATES配置正确性
   打开项目settings.py，检查TEMPLATES中的DIRS配置是否为正确路径：

   TEMPLATES = [
       {
           'BACKEND': 'django.template.backends.django.DjangoTemplates',
           'DIRS': [BASE_DIR / 'templates'],  # Django 4.2推荐使用路径对象写法
           'APP_DIRS': 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',
               ],
           },
       },
   ]
   

   若使用字符串拼接，需确保是os.path.join(BASE_DIR, 'templates')，且已导入os模块。

2. 核对模板文件实际位置
   确保项目目录结构符合以下规范：

   my_blog/
   ├── my_blog/
   │   ├── settings.py
   │   └── ...
   ├── blog/
   │   ├── views.py
   │   └── ...
   └── templates/
       ├── base.html
       └── blog/
           └── index.html
   

   确认base.html在项目根目录的templates文件夹下，index.html在templates/blog/子目录中。

3. 修正视图函数的模板路径
   视图函数中正确的模板路径写法应为：

   def homepage(request):
       return render(request, "blog/index.html")
   

   Django会自动在TEMPLATES配置的DIRS目录下查找模板，无需添加templates前缀。

4. 清理Django缓存并重启服务
   运行以下命令清理缓存：

   python manage.py clearcache
   

   之后重启Django开发服务器，避免缓存导致的模板查找异常。

5. 确认INSTALLED_APPS配置
   检查settings.py中的INSTALLED_APPS，确保blog应用已添加：

   INSTALLED_APPS = [
       'django.contrib.admin',
       'django.contrib.auth',
       'django.contrib.contenttypes',
       'django.contrib.sessions',
       'django.contrib.messages',
       'django.contrib.staticfiles',
       'blog',  # 确认该行存在
   ]
   

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