在 Jinja 模板里，子模板重写父模板的 block 后，父区块的默认内容不会自动拼接进来。要实现“保留公共内容，再补充当前页面内容”，关键写法只有一处：在子区块内部调用 {{ super() }}。它会返回父区块的渲染结果，随后再输出子模板自己的标记。

官方地址：https://jinja.palletsprojects.com/en/stable/templates/

把父模板当作公共骨架，把子模板当作差异层；需要追加时调用 super()，需要完全接管时才省略它。

先定位：为什么子模板内容一出现，父内容就不见了

下面的父模板提供一个公共标题和内容区块。block 的作用是声明“这里可以被子模板覆盖”，并不意味着子模板会自动获得父区块文本。

  {% block head %}
    {# 父模板提供公共样式入口，子模板可以选择追加或替换 #}
    
  {% endblock %}


  

    {% block content %}
      {# 这是内容区块的默认提示 #}
      
这里是公共内容提示。
    {% endblock %}
  

如果子模板这样写：

{% extends "base.html" %}

{% block content %}
  {# 这里直接写新内容，会替换父 content 的默认内容 #}
  
订单列表
{% endblock %}

渲染结果只会留下“订单列表”，父模板里的公共提示已经被这个同名 block 接管。这不是 Jinja 丢数据，而是模板继承的正常语义：子 block 是父 block 的替代实现。

用 super 保留父内容，再补充子模板片段

需要保留父区块时，把 {{ super() }} 放在子 block 内。它的返回值就是父区块原本会产生的内容，因此可以先追加、后追加，也可以把它放进一个更具体的容器中。

{% extends "base.html" %}

{% block title %}订单列表{% endblock %}

{% block head %}
  {{ super() }}
  {# 保留父模板的样式和 title 结构，再补充当前页面的元信息 #}
  
{% endblock %}

{% block content %}
  {{ super() }}
  {# 父区块的提示先保留，再增加当前页面自己的内容 #}
  
订单列表
    
这里显示当前团队可以访问的订单。
  
{% endblock %}

这个写法的判断重点是位置。super() 放在开头，父内容出现在新增内容前；放在末尾，公共说明会落到页面后面。对 head 区块来说，通常先调用父内容再增加 meta 或脚本；对 content 区块来说，要根据阅读顺序决定是“公共提示后接业务主体”，还是“业务主体后接公共说明”。

如果父区块包含多个嵌套 block，super() 返回的是整个父 block 的渲染结果，不是只返回某一个内部标签。需要拆分职责时，应在父模板中把区块设计得更小，而不是在子模板里猜测字符串位置。

区分：追加、完整替换和多级继承

模板问题通常不是语法不会写，而是没有先决定区块的责任边界。可以按下面三种情况处理：

例如在三层模板中，child.html 已经给 body 增加了通用包装，grandchild.html 若要跳过这一层，可以使用 super.super()。但这会让模板层次更紧耦合，只有在中间层职责稳定时才值得采用；更常见的做法是把公共片段抽到 include 或宏中。

另一个容易混淆的边界是作用域。把 block 写在循环里时，默认情况下 block 不能直接访问循环变量，这是为了保证子模板替换该 block 时不会凭空依赖外层变量。确实需要读取当前项时，在父模板声明 scoped：

{% for item in items %}
  {# scoped 显式把当前循环项提供给这个可覆盖区块 #}
  {% block loop_item scoped %}
    
{{ item.name }}
  {% endblock loop_item %}
{% endfor %}

最后排查：避免无意覆盖父模板

遇到“公共标题、样式或提示消失”时，可以按这个顺序看：

1. 确认 {% extends %} 是子模板的第一个标签，前面不要放会直接输出的 HTML。
2. 确认子模板重写的 block 名称与父模板完全一致；名称不一致不会产生你期待的继承关系。
3. 需要追加时补上 {{ super() }}，并根据页面顺序决定它放在前面还是后面。
4. 检查同一模板是否重复声明同名 block；Jinja 不允许这样做，因为引擎无法判断父模板应该接收哪份内容。
5. 若 block 位于循环中，确认是否需要 scoped，不要把外层循环变量当成全局变量使用。

最终可以把模板层次压缩成一句话：父模板定义稳定结构，子模板定义差异；子模板省略 super() 就是替换，调用 super() 才是追加。先确定区块责任，再选择写法，排查会比盲目移动 HTML 快得多。

常见问题

为什么我写了 super 但父内容仍然没有出现？

先确认它写在同名 block 内，并且使用的是表达式 {{ super() }}，不是把它放进不会渲染的注释；同时检查实际继承的父模板文件是否就是你修改的那一份。

子模板能不能同时追加多个父区块？

可以。分别重写需要调整的 block，在每个 block 内单独调用 super()。不需要改动的区块不要重复声明，Jinja 会继续使用父模板版本。