本文详解 Flask 中常见的“Template not found”及 Jinja2 语法（如 {% block %} 缺失）导致的渲染失败问题，涵盖模板目录结构、继承写法、视图函数配合要点，并提供可直接运行的示例代码。
本文详解 flask 中常见的“template not found”及 jinja2 语法（如 `{% block %}` 缺失）导致的渲染失败问题，涵盖模板目录结构、继承写法、视图函数配合要点，并提供可直接运行的示例代码。
在 Flask 开发中，初学者常因混淆 Django 与 Flask 的模板语法，或忽略 Flask 对模板路径与结构的严格约定，而遭遇 TemplateNotFound 错误或 Jinja2 解析异常（例如 Invalid block tag: 'endblock' 或未闭合的 {% block %}）。这类问题并非环境配置或依赖缺失所致（如安装 Django 完全无关），而是源于对 Flask 默认模板机制的理解偏差。
✅ 正确的模板结构与继承流程
Flask 默认使用 Jinja2 作为模板引擎，不支持 Django 风格的 {% load %} 或 {% url %} 等语法，但完全兼容标准 Jinja2 语法（如 {% extends %}、 {% block %}、{{ variable }}）。关键前提是：所有模板必须存放在项目根目录下的 templates/ 文件夹中（Flask 自动识别该路径），且继承关系需严格闭环。
1. 创建基础模板 templates/base.html
<!DOCTYPE html>
<html>
<head>
<title>{% block title %}My App{% endblock %}</title>
</head>
<body>
<nav class="navbar navbar-default">
<div class="container-fluid">
<div class="navbar-header">
<a class="navbar-brand" href="#">FSMA</a>
</div>
<ul class="nav navbar-nav">
<li><a href="/show">Show</a></li>
</ul>
</div>
</nav>
<!-- 主体内容占位区，子模板在此注入 -->
{% block body %}{% endblock %}
</body>
</html>⚠️ 注意：{% block body %} 必须配对 {% endblock %}；Jinja2 不允许遗漏结束标签，否则会抛出 TemplateSyntaxError —— 这正是提问者截图中第 18 行报错的根本原因。
2. 创建子模板 templates/sample.html
{% extends "base.html" %}
{% block title %}FSMA - Show Page{% endblock %}
{% block body %}
<div class="container">
<h1>Flask show var data</h1>
<p>{{ data }}</p>
</div>
{% endblock %}- {% extends "base.html" %} 告诉 Jinja2 当前模板继承自 base.html；
- {% block title %} 和 {% block body %} 分别覆盖父模板中同名区块；
- 所有 {{ data }} 变量均来自视图函数传入的上下文。
3. 在视图中正确渲染模板
确保路由函数调用 render_template() 并传入匹配的变量名：
from flask import Flask, render_template
app = Flask(__name__)
@app.route('/show')
def simple_show_data():
data = "From Python"
return render_template("sample.html", data=data) # ✅ 键名 'data' 必须与模板中 {{ data }} 一致? 常见错误排查清单
| 问题现象 | 根本原因 | 解决方案 |
|---|---|---|
| TemplateNotFound: sample.html | 模板未放在 templates/ 目录下，或文件名拼写错误（如 Sample.html） | 检查路径：your_project/templates/sample.html；确认大小写与扩展名 |
| TemplateSyntaxError: Invalid block tag | {% block %} 缺少 {% endblock %}，或嵌套不合法 | 使用编辑器高亮检查所有 {% ... %} 标签是否成对；推荐 VS Code + Jinja2 插件 |
| 页面显示空内容，无报错 | 视图传参键名与模板变量名不一致（如传 my_data 却写 {{ data }}） | 统一命名，或使用 {{ data or 'default' }} 避免静默失败 |
| 样式/导航栏不生效 | 子模板未正确继承 base.html，或 extends 语句不在首行 | {% extends %} 必须是模板第一行（前面不可有空格或注释） |
✅ 最小可运行验证示例
# 项目结构应为：
my_flask_app/
├── app.py
└── templates/
├── base.html
└── sample.html启动后访问 http://127.0.0.1:5000/show，即可看到带导航栏和动态文本的完整页面。
? 提示：Flask 不会自动重载模板修改（除非开启调试模式）。开发时务必设置 app.run(debug=True)，并确认控制台输出 * Restarting with stat 表示热重载已启用。
掌握模板继承机制是构建可维护 Flask 应用的基础。与其尝试混用 Django 语法，不如深入理解 Jinja2 的设计哲学：简洁、显式、基于继承。一次规范的 base.html + extends 实践，将为你规避 90% 的前端渲染类故障。
