flask 中模板继承不生效，往往并非语法错误，而是路由错误地渲染了父模板而非子模板；正确做法是始终通过 render_template() 渲染子模板文件，由其自动加载并继承父模板。
flask 中模板继承不生效，往往并非语法错误，而是路由错误地渲染了父模板而非子模板；正确做法是始终通过 render_template() 渲染子模板文件，由其自动加载并继承父模板。
在 Flask 中，模板继承（Template Inheritance）是组织 HTML 结构的核心机制，依赖 {% extends %} 和 {% block %} 语法实现复用。但初学者常遇到“子模板内容不显示”的问题——例如定义了 base.html 和 child.html，却只看到
TEST BLOCK
，而 Output 完全缺失。这通常不是 Jinja2 语法问题，而是视图函数中调用了错误的模板路径。
✅ 正确的模板继承结构
首先，确保模板文件层级清晰、语法规范：
templates/base.html（父模板，定义骨架与可替换区块）：
<!DOCTYPE html> <html> <head><title>{% block title %}My Site{% endblock %}</title></head> <body> <header><h1>Welcome to My App</h1></header> <main> {% block content %}{% endblock %} </main> </body> </html>templates/child.html（子模板，继承并填充内容）：
{% extends "base.html" %} {% block title %}Home Page{% endblock %} {% block content %} <p>Hello, World! This is rendered via template inheritance.</p> {% endblock %}⚠️ 关键注意：
- extends 必须是子模板第一行非空、非注释内容；
- base.html 和 child.html 需位于 templates/ 目录下（Flask 默认查找路径）；
- 绝不使用 {% include %} 替代 {% extends %} —— include 是静态嵌入，不支持块覆盖，会导致继承逻辑完全失效（如原答案中误用 include 的写法是错误示范，不可效仿）。
? 常见错误：路由指向父模板
问题根源几乎总是出现在视图函数中：
❌ 错误写法（导致仅渲染 base.html，忽略子模板逻辑）：
@views.route('/') def home(): return render_template('base.html') # ❌ 渲染父模板 → content 区域为空✅ 正确写法（由子模板触发继承流程）：
@views.route('/') def home(): return render_template('child.html') # ✅ 渲染子模板 → 自动加载 base.html 并注入 contentFlask 的模板引擎在解析 child.html 时，会主动读取 base.html，定位 {% block content %} 并用子模板中的内容替换。若直接渲染 base.html，Jinja2 不会反向查找或执行任何继承逻辑——{% block %} 仅作为占位符存在，无默认内容即为空白。
? 调试建议
- 检查浏览器返回的 HTML 源码，确认是否真的输出了子模板内容；
- 在 base.html 的 {% block content %} 中添加默认文本（如 default content），便于判断是否被正确覆盖；
- 启用 Flask 调试模式（app.run(debug=True)），Jinja2 报错（如模板未找到）会清晰提示路径问题；
- 确保文件名拼写一致（如 child.html ≠ child.htm），且无隐藏字符或 bom 头。
✅ 总结
Flask 模板继承能否生效，90% 取决于你调用的是哪个模板文件。牢记原则：
? 继承关系由子模板声明（{% extends “xxx” %}）；
? 渲染入口必须是子模板（render_template(‘child.html’)）；
? 父模板仅作结构定义，永远不应被直接渲染。
遵循这一模式，即可稳定实现布局复用、标题动态化、CSS/js 按需加载等专业 Web 开发实践。