Django应用内正确扩展模板的方法求助

1. 先确认模板目录结构是否合规 #

应用层级模板必须放在应用目录下的templates文件夹内，为了避免和其他应用的模板重名（Django会按INSTALLED_APPS顺序查找），最好在templates里再建一个和应用同名的子文件夹，正确结构应该是这样：

你的项目/
└── store/
    ├── templates/
    │   └── store/  # 这层必须和应用名一致，核心关键
    │       ├── test.html
    │       └── store.html
    ├── urls.py
    ├── views.py
    └── ...

2. 修正继承路径写法 #

按上面的结构，store.html里的继承代码要写成：

{% extends 'store/test.html' %}

要是你没套应用名子目录（不推荐，容易冲突），结构是store/templates/test.html，那继承语句就是：

{% extends 'test.html' %}

3. 清缓存+重启服务器 #

Django开发环境可能缓存了旧的模板配置，先清缓存再重启：

python manage.py clearcache

然后关掉当前的开发服务器，重新运行python manage.py runserver。

4. 检查基础模板的block标签 #

test.html里必须至少有一个{% block %}标签，不然继承后不会渲染任何内容，比如：

<!-- test.html 示例 -->
<!DOCTYPE html>
<html>
<head>
    <title>{% block page_title %}默认标题{% endblock %}</title>
</head>
<body>
    <nav>你的导航栏代码</nav>
    {% block main_content %}{% endblock %}
</body>
</html>

store.html里要对应写匹配的block：

{% extends 'store/test.html' %}

{% block page_title %}商店页面{% endblock %}

{% block main_content %}
<!-- 你的Bootstrap代码 -->
{% endblock %}

5. 排查模板加载路径（可选） #

如果还是不行，在视图里加一段代码，打印Django查找模板的路径，确认应用的模板目录被正确识别：

# store/views.py
from django.shortcuts import render
from django.template.loader import get_template_sources

def store(request):
    # 打印模板查找路径
    print(list(get_template_sources('store/test.html')))
    # 尝试加载模板看是否报错
    try:
        get_template('store/test.html')
        print("基础模板能正常加载")
    except Exception as e:
        print(f"加载失败原因: {e}")
    return render(request, 'store/store.html')

运行服务器后看控制台输出，确认store/templates/store/test.html在查找列表里。

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