本文介绍如何利用 flask 模板引擎自动渲染数据库查询结果为 html 表格，无需手动编写大量 `
在 Web 开发中，将数据库查询结果动态呈现为 HTML 表格是常见需求。若表中包含 50 行甚至上千行数据，硬编码
✅ 核心三步法
- 后端获取数据：使用 SQLAlchemy、sqlite3 或其他 ORM/驱动从数据库读取结果（建议返回字典列表，如 [{‘id’: 1, ‘name’: ‘Alice’}, …]）；
- 传递至模板：通过 render_template('template.html', data=rows) 将数据作为上下文变量传入；
- 前端动态渲染：在 .html 模板中用 {% for row in data %} 遍历并插入单元格。
以下是一个完整可运行示例：
# app.py
from flask import Flask, render_template
app = Flask(__name__)
# 示例：实际项目中请替换为真实数据库查询
# 如：rows = db.session.execute("SELECT id, name, age FROM users").mappings().all()
rows = [
{'id': 1, 'name': 'John', 'age': 25},
{'id': 2, 'name': 'Jane', 'age': 30},
{'id': 3, 'name': 'Bob', 'age': 28},
]
@app.route('/')
def index():
return render_template('table.html', rows=rows)对应模板 templates/table.html：
动态用户表格
用户数据表（共 {{ rows|length }} 条记录）
| ID | 姓名 | 年龄 |
|---|---|---|
| {{ row.id }} | {{ row.name | default('N/A') }} | {{ row.age or '未知' }} |
| 暂无数据 | ||
⚠️ 注意事项与最佳实践
- 安全输出：Jinja2 默认对 {{ ... }} 内容进行 HTML 转义，防止 XSS 攻击；如需渲染富文本，请显式使用 |safe 过滤器（务必确保内容可信）。
- 空数据处理：使用 {% else %} 子句优雅处理空列表，提升用户体验。
- 性能优化：对于大数据集（如 >10,000 行），避免全量渲染，应结合分页（flask-sqlalchemy.paginate()）或前端虚拟滚动。
- 字段动态化：若列名不固定，可在视图中传入 headers=['id', 'name', 'age']，并在模板中用嵌套循环生成表头与单元格，进一步提升通用性。
通过以上方式，你只需关注数据获取逻辑，HTML 结构由模板自动完成——真正实现「数据驱动 UI」，兼顾开发效率与代码健壮性。
立即学习“前端免费学习笔记（深入）”；
