Django多级模板继承问题：toolbar_content内容无法显示求助

你遇到的核心问题是：用{% include %}引入的模板中定义的块，无法被继承父模板的子模板覆盖。因为{% include %}是在渲染时将目标模板的内容静态插入到当前模板中，被插入的模板里的块属于独立的模板上下文，不在父模板（base.html）的继承块层级里，所以子模板（toolbar_content.html）的块覆盖无法生效。

下面提供两种可行的解决思路：

方法一：将Toolbar结构直接整合到Base模板中 #

把Toolbar的固定结构直接写在base.html里，并在其中定义toolbar_content块，这样子模板就能直接覆盖该块：

base.html #

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    {% block title %}默认标题{% endblock %}
</head>
<body>
    <!-- Toolbar 固定结构 -->
    <div class="toolbar-container">
        {% block toolbar_content %}
            <!-- 可选：Toolbar默认内容 -->
        {% endblock %}
    </div>

    <!-- 页面主体内容块 -->
    {% block content %}{% endblock %}
</body>
</html>

toolbar_content.html #

直接继承base.html，填充toolbar_content块即可：

{% extends 'base.html' %}

{% block toolbar_content %}
    <!-- 你的Toolbar内容 -->
    <a href="/home">首页</a>
    <button>退出登录</button>
{% endblock %}

{% block content %}
    <h1>页面内容区域</h1>
{% endblock %}

方法二：用模板继承替代include（保留独立的Toolbar模板） #

如果希望Toolbar保持独立模板，可以让base.html继承toolbar.html，把toolbar.html作为基础模板定义块，再让子模板继承base.html：

toolbar.html（作为基础模板） #

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    {% block title %}默认标题{% endblock %}
</head>
<body>
    <div class="toolbar-container">
        {% block toolbar_content %}
            <!-- Toolbar默认内容 -->
        {% endblock %}
    </div>

    <!-- 预留页面内容块，供后续模板填充 -->
    {% block content %}{% endblock %}
</body>
</html>

base.html（继承toolbar.html，扩展通用内容） #

{% extends 'components/toolbar.html' %}

{% block title %}我的网站{% endblock %}

<!-- 可选：保留Toolbar默认内容并添加新内容 -->
{% block toolbar_content %}
    {{ block.super }}
    <span>用户：张三</span>
{% endblock %}

toolbar_content.html（继承base.html，自定义Toolbar内容） #

{% extends 'base.html' %}

{% block toolbar_content %}
    <!-- 完全替换Toolbar内容，或用{{ block.super }}保留原有内容 -->
    <nav>
        <a href="/dashboard">控制台</a>
        <a href="/settings">设置</a>
    </nav>
{% endblock %}

{% block content %}
    <p>这是页面主体内容</p>
{% endblock %}

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