Jinja2 不能直接渲染 DataFrame 或 SQLAlchemy Row 对象，必须先转换为字典列表（如 to_dict('records') 或 [dict(row) for row in result]），才能在模板中用 {% for %} 和 {{ item.field }} 正确访问。
Jinja2 可以直接渲染字典对象——问题不在“能不能”，而在于你传的是不是标准 Python dict，以及模板里访问的方式对不对。常见报错（如 UndefinedError、空白选项、{{ item.name }} 不展开）几乎都源于数据结构不匹配或访问路径错误。
为什么 df 或 Row 传进模板后遍历失败？
因为它们不是字典，也不是可迭代的字典列表：
-
pandas.DataFrame是自定义类，Jinja2 不认识.iloc或属性点号访问（如row.employee_name） -
sqlalchemy.engine.Row（尤其是 2.0+ 默认返回）是命名元组-like 对象，不支持row['name']，也不响应for k, v in row.items() - 直接
for item in data时，若data是Row，Jinja2 会按字段名迭代（如item是字符串"id"），而不是按行
怎么把查询结果变成 Jinja2 能用的字典？
关键不是“转成 dict”，而是转成“字典列表”或“可键访问的字典”：
- Pandas：用
df.to_dict('records')→[{"id": 1, "name": "Alice"}, ...] - SQLAlchemy Core（
conn.execute().fetchall()）：用[dict(row) for row in result] - SQLAlchemy ORM 查询（
session.query(User).all()）：用[u.__dict__ for u in users]，但注意__dict__含私有字段，建议显式构造：[{"id": u.id, "name": u.name} for u in users] - 如果只要单个对象（如详情页），传
user.__dict__或vars(user)即可，模板中写{{ user.name }}
模板里访问字典字段总报 UndefinedError？
不是 Jinja2 不能渲染字典，是你没确认键是否存在或拼写是否一致：
Flask Wrap
下载
火焰围攻 授权: q15040409-creator.功能概述火焰围攻 授权: q15040409-creator.是一项面向实际任务的技能，主要用于Description.；Flask Web. - Python.；核心要点HTTP?；.Version.1.0.tags. wrap.github.automation.。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。使用与执行使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要
立即学习“Python免费学习笔记（深入）”；
- Python 字典 key 区分大小写，
{"EmployeeName": "John"}中不能写{{ user.employeename }} - 避免在模板里用
.get()——Jinja2 不支持方法调用（{{ user.get('name') }}会报错），改用{{ user.name or '' }}或{{ user.name if user.name else 'N/A' }} - 空值安全写法：
{% if users %}{% for u in users %}{{ u.name }}{% endfor %}{% endif %}；别依赖users是 list，传参前确保它是[]而非None - 调试技巧：在视图函数里加
print(employees[0].keys() if employees else 'empty')，确认第一项的 key 名
为什么有时 {{ data }} 显示原样字符串，而不是内容？
这通常和模板加载机制有关，而非字典本身：
- 静态文件服务器（如 Nginx 直接 serve
.html）绕过了 Flask，Jinja2 根本没运行 → 检查请求是否走的是render_template路由 - 模板扩展名不是
.html或路径不在templates/下 → Jinja2 找不到文件，返回原始文本 - 用了
autoescape=True且传入了含 HTML 的字符串 → 内容被转义成纯文本，看起来像“没渲染”，实际已渲染但被编码了
最常被忽略的一点：Jinja2 渲染的是“传进去的东西”，不是“你脑子里想传的东西”。打印、验证、再传——三步少一步，{{ }} 就只是字面量。
