base.html 必须定义 block 才能让子模板覆盖内容，否则未设 block 的区域彻底锁死；至少需 {% block title %}{% endblock %} 和 {% block content %}{% endblock %}，且 {% extends %} 必须首行、路径准确、区分大小写。
base.html 里必须定义 block，否则子模板无法覆盖内容
子模板继承时能“填空”的唯一方式，就是父模板用 {% block name %}{% endblock %} 明确划出可替换区域。没写 block 的地方，子模板完全没法动——不是“默认继承”，而是彻底锁死。
常见错误是只在 base.html 写了 {% load static %} 或通用 <head>，但没把标题、主内容、侧边栏这些关键位置包进 block。结果子页只能复制粘贴整页 HTML，复用率归零。
-
base.html至少要有{% block title %}{% endblock %}和{% block content %}{% endblock %} - 如果用了
{% block extra_css %}{% endblock %}，子页才能按需加样式，而不是全站强塞一个main.css - 别在
block外写业务相关 HTML——比如把某个按钮直接写死在base.html的<body>里，它永远删不掉
子模板用 extends 必须放在第一行，且路径要对
Django 解析模板时，{% extends "base.html" %} 必须是文件最开头（前面不能有空行、注释或空格），否则直接报错：Invalid block tag on line X: 'extends'. Did you forget to register or load this tag?
路径问题更隐蔽：Django 默认从 TEMPLATES['DIRS'] 和每个 app 的 templates/ 下找。如果你把 base.html 放在 myapp/templates/base.html，子模板就得写 {% extends "base.html" %}；但如果它在 templates/base/base.html，就必须写 {% extends "base/base.html" %}。
立即学习“Python免费学习笔记（深入）”；
- 推荐统一放在项目级
templates/目录下（如myproject/templates/base.html），并在settings.py的TEMPLATES['DIRS']加上[BASE_DIR / "templates"] - 路径区分大小写，Windows 下可能不报错，Linux 部署后直接 500
- 用
{% extends "base.html" %}而不是{% extends "./base.html" %}—— Django 不支持相对路径语法
block 嵌套和 super 是控制继承深度的关键
子模板里的 block 不是只能全量重写——用 {{ block.super }} 可以保留父模板该 block 的原有内容，再追加或前置新内容。这对页脚版权、全局 JS 初始化特别有用。
但要注意：super 只能出现在 block 内部，且只能调用直接父级的 block 内容。如果中间某层模板没写 block，链就断了。
- 想让所有页面都带 Google Analytics，就在
base.html的{% block scripts %}{% endblock %}末尾加<script>ga(...)</script>，子页用{{ block.super }}继承并补自己的 JS - 避免三层继承（A → B → C）时 B 忘记写
{% block xxx %}{{ block.super }}{% endblock %}，导致 C 完全拿不到 A 的原始内容 -
{{ block.super }}是字符串拼接，不是作用域继承——不能靠它访问父模板里的变量
调试模板继承失败，优先看 TemplateDoesNotExist 和 Invalid block tag
两个高频错误码直接对应两类问题：TemplateDoesNotExist 是路径或命名不对；Invalid block tag 是语法位置错了，或者用了未加载的 template tag。
开发时打开 DEBUG = True，Django 模板错误页面会明确标出哪行、哪个文件出问题。但生产环境关了 DEBUG，这类错误就变成静默白屏或 500，排查成本陡增。
- 遇到
TemplateDoesNotExist，立刻检查python manage.py show_templates（需 django-extensions）或手动确认base.html是否在settings.TEMPLATES[0]['DIRS']列出的路径中 -
Invalid block tag很可能是子模板第一行有 UTF-8 BOM、隐藏空格，或用了中文全角符号代替英文大括号 - 别依赖 IDE 的“模板高亮”——很多编辑器不识别 Django 模板语法，显示正常不代表能跑通
block 边界的理解是否一致。一个没写 block 的 base.html，比十个写满逻辑的视图函数更难维护。 
