render_template传参变量名须与模板引用名严格一致，否则Jinja2静默渲染为空；模板中变量默认转义，可信HTML需显式|safe；路径仅限templates目录下；嵌套访问失败返回None而非报错。
render_template 传参时变量名和模板中引用名必须一致
Flask 的 render_template 函数本身不校验变量名是否在模板里被使用，但如果你传了 user_name="Alice"，却在模板里写 {{ username }}（少个下划线），Jinja2 就会静默渲染为空字符串——没有报错，也不提示，容易排查半天才发现是拼写不一致。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 传参用关键字参数，避免用字典解包（如
**context），除非你明确控制键名；字典键名一旦拼错或大小写不对，模板就收不到值 - 模板里用
{{ user_name|default('Guest') }}显式兜底，而不是依赖后端一定传值 - 开发时可在模板开头加
{% if not user_name %}DEBUG: user_name missing{% endif %}快速定位漏传
Jinja2 中变量渲染默认转义，要显示 HTML 得显式标记 safe
比如后端传了 content = "<strong>Hello</strong>"，模板写 {{ content }} 渲染出来就是纯文本 <strong>Hello</strong>，而不是加粗的 Hello。这是 Jinja2 默认行为，防 XSS，不是 bug。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 确认内容可信（如管理员后台富文本）再用
{{ content|safe }} - 不要全局关转义（比如配
autoescape=False），风险太大 - 若需部分 HTML 片段，考虑用宏（
{% macro %}）封装，比裸用|safe更可控
render_template 查找模板路径以 templates 目录为根，不支持相对路径上溯
Flask 默认只在应用根目录下的 templates 文件夹里找模板。哪怕你在视图函数里写 render_template("../admin/base.html")，Jinja2 会直接报 TemplateNotFound 错误，不会解析上级路径。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 所有模板路径都从
templates开始写，比如render_template("admin/dashboard.html")对应templates/admin/dashboard.html - 不要用
os.path.join拼路径传给render_template，它只接受字符串路径 - 如果真要动态切换模板根目录，得自定义
Jinja2 Environment并替换app.jinja_env，但绝大多数项目没必要
变量嵌套访问（如 user.profile.avatar）失败时静默返回 None，不是 KeyError
Jinja2 访问 {{ user.profile.avatar }} 时，如果 user 是 dict 但没 profile 键，或 profile 是 None，它不会抛异常，而是整个表达式求值为 None，最终渲染为空。这跟 Python 的点号访问行为完全不同。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用
{{ user.profile.avatar if user.profile else '' }}或更稳妥的{{ (user.profile or {}).get('avatar', '') }} - 后端传参前做结构校验（例如用
dataclasses或 Pydantic 模型），比在模板里层层判空更可靠 - 调试时可在模板里临时加
{{ user|pprint }}看实际结构（需开启app.jinja_env.add_extension('jinja2.ext.debug')）
