Django模板继承写法与复用技巧

Django模板继承看似简单，实则暗藏三大关键陷阱：block名称必须严格一致（区分大小写）、模板路径始终相对于项目templates根目录而非文件位置、{{ block.super }}必须置于同名block内且符合HTML语义结构——任一疏忽都会导致内容静默失效、渲染错乱或资源重复加载，而Django往往不报错，只让页面“看起来不太对”，掌握这三处精准控制，才能真正实现高复用、易维护、无隐患的模板架构。

base.html 必须定义 block，否则子模板继承无效

子模板里用 {% extends "base.html" %} 只是声明继承关系，真正能填内容的位置，得靠 base.html 里提前写好 {% block content %}{% endblock %} 这类占位。没定义 block，子模板里的 {% block content %}... 就完全不生效，页面空白或内容错位都可能发生。

常见错误现象：base.html 里只写了 HTML 结构，但漏掉 {% block %}；或者子模板写了 {% block main %}，而 base.html 里对应的是 {% block content %}，名字不一致导致内容被忽略。

• base.html 至少要包含一个 {% block %}，推荐拆成 title、head_extra、content、footer 等语义化名称
• 子模板中 {% block xxx %} 的名称必须和 base.html 中完全一致（区分大小写）
• 如果想让子模板“追加”而非“替换”内容，用 {{ block.super }}，比如在子模板的 {% block head_extra %} 里加 JS，同时保留父模板已有的 CSS 引入

Django 模板继承不支持多级嵌套？其实是支持的，但路径容易写错

可以 base.html → layout.html → article_detail.html 三级继承，关键在于每层 {% extends %} 的路径都是相对于 TEMPLATES['DIRS'] 或 app/templates/ 的根目录，不是相对当前文件位置。

使用场景：大型项目常把通用结构抽成 base.html，再按模块建 dashboard/base.html、admin/base.html 等中间层，避免所有页面直连顶层。

• 路径写成 {% extends "dashboard/base.html" %}，而不是 {% extends "../dashboard/base.html" %} —— Django 不认点号路径
• 如果 layout.html 放在 myapp/templates/myapp/layout.html，那它引用父模板得写 {% extends "base.html" %}（假设 base.html 在 templates/base.html），而不是 {% extends "myapp/base.html" %}
• 调试时可打开 DEBUG=True，Django 报错会明确提示 TemplateDoesNotExist: xxx.html，说明路径不对

block.super 用错位置会导致渲染顺序混乱

{{ block.super }} 是把父模板同名 block 的内容插入当前位置，但它不是“自动拼接”，而是严格按子模板中写的顺序执行。放错位置，比如放在 HTML 标签中间或闭合标签之后，会直接破坏 DOM 结构。

性能影响很小，但逻辑错乱很隐蔽：比如父模板 block title 输出 ，子模板写成 是对的；但如果写成 {{ block.super }}，就会变成 ，浏览器只认第一个