render_template()通过关键字参数传变量，如render_template("a.html", name="Alice")，模板中用{{ name }}获取；变量名须与传参名一致，不可为Python关键字，路径仅限templates目录下。
render_template() 怎么传变量进去
直接在 render_template() 的参数里写变量名=值，模板里用 {{ 变量名 }} 取。Flask 会自动把关键字参数转成模板上下文。
常见错误：传了字典但没解包，比如 render_template("index.html", data={"name": "Alice"})，结果模板里得写 {{ data.name }}；其实更常用的是直接解包：render_template("index.html", **data)，这样模板里就能直接用 {{ name }}。
- 支持任意数量的关键字参数：
render_template("page.html", title="首页", items=[1,2,3], active=True) - 变量名不能是 Python 关键字（如
class、for），否则 Jinja2 解析报错TemplateSyntaxError - 如果变量可能为
None，模板中建议用{{ user.name|default("匿名") }}避免UndefinedError
为什么页面显示 {{ name }} 而不是实际值
八成是忘了调用 render_template()，写了 return "index.html" 或 return send_file("templates/index.html") —— 这些都不会触发模板渲染，纯文本返回，Jinja2 语法原样输出。
另一个常见原因是模板路径不对：render_template() 默认只认 templates/ 目录下的文件，且不接受绝对路径或 ../ 回退。比如项目结构是 app.py 和 templates/base.html，必须写 render_template("base.html")，不能写 render_template("templates/base.html") 或 render_template("./templates/base.html")。
立即学习“前端免费学习笔记（深入）”；
- 检查 Flask 启动时有没有警告
Template not found - 确认视图函数返回的是
render_template()的结果，而不是字符串或Response对象误包 - 调试时可在视图里加
print(request.endpoint)确认路由确实命中了该函数
怎么传复杂数据（列表、字典、对象）
Jinja2 原生支持 Python 的基本类型，列表遍历用 {% for item in items %}{{ item }}{% endfor %}，字典用 {{ config.db_host }} 或 {{ config["db_host"] }} 都行。但注意：对象属性访问受 __getattr__ 和 __getitem__ 控制，普通类如果没有实现这些，模板里取属性会报 UndefinedError。
- 推荐用
dataclasses或pydantic.BaseModel构建数据对象，属性可直接访问 - 列表推导在模板里不支持，想过滤要用
selectattr过滤器：{% for u in users if u.active %}❌，应写成{% for u in users|selectattr("active") %}✅ - 避免在模板里做复杂计算，比如
{{ (a + b) * 0.15 | round(2) }}可以，但不要写数据库查询或 IO 操作
静态文件路径和 url_for() 容易出什么问题
HTML 里写 <img src="static/logo.png"> 看似能加载，但一旦启用 URL 前缀（如 Nginx 反向代理到 /myapp/）、或用了蓝本（Blueprint），硬编码路径就失效。正确做法是全部用 {{ url_for("static", filename="logo.png") }}。
url_for() 第一个参数是端点名，不是文件路径。“static” 是 Flask 内置端点，对应 static/ 目录；如果是蓝本里的视图，端点是 blueprint_name.view_name，漏写蓝本前缀就会 404。
- 模板里引用 CSS/JS 一定要用
url_for()，哪怕开发期看着“能跑”也要改掉硬编码 -
url_for()不会校验文件是否存在，拼错filename会导致 404，但不会报模板错误 - 自定义静态文件夹需在创建 Flask 实例时指定：
Flask(__name__, static_folder="/path/to/static")，否则仍按默认static/找
变量传递本身很简单，真正卡住人的往往是路径配置、端点命名、以及把模板当纯 HTML 来写——Jinja2 的语法边界和 Python 运行时是隔离的，模板里看不到视图函数的局部变量，只看得到 render_template() 显式传入的内容。
