应在SQL中用WHERE条件过滤而非导出HTML后前端过滤，因后者性能差、易漏数据；正确做法是SELECT时直接加WHERE，并注意数据库日期语法差异；CLI导出更可控，pandas需设encoding和escape；大数据量应选CSV而非HTML。
WHERE 条件写在 SQL 里，不是导出后再过滤
导出 html 本质是把查询结果渲染成表格，如果先查全表再用前端 js 过滤，不仅慢、内存爆、html 文件巨大，还可能漏掉分页外的数据。真正可控的方式，是在 select 语句里直接加 where。
- 错误做法：用
SELECT * FROM orders导出全部，再用浏览器搜索“status = 'shipped'”——查不到，因为 HTML 里没保留原始字段语义 - 正确做法：导出前确认业务条件，比如“2024 年已发货订单”，写成
SELECT id, created_at, amount FROM orders WHERE status = 'shipped' AND created_at >= '2024-01-01' - 注意日期格式：MySQL 默认支持
'2024-01-01'，但 SQLite 需用date('2024-01-01')，PostgreSQL 对时区敏感，建议显式加AT TIME ZONE 'UTC'
用 CLI 工具导出时，别依赖 GUI 的“另存为”按钮
很多数据库客户端（如 DBeaver、TablePlus）的“导出为 HTML”功能，实际调用的是内置模板，不支持自定义 CSS 或分页，且默认会把 NULL 渲染成空格或 ，导致数据对不齐。
- 推荐用命令行直出：MySQL 可用
mysql -e "SELECT ... WHERE ..." database_name > output.html，但需手动补 HTML 头尾 - 更稳的做法是管道接
sed或awk生成简易表格，例如：mysql -N -s -e "SELECT id, name FROM users WHERE active=1" mydb | sed 's/\t/<td>/g; s/$/<\/td>/; s/^/<tr><td>/; s/$/<\/tr>/' | sed '1s/^/<table border="1">/; $s/$/<\/table>/' > users.html
-
-N去列名，-s禁用美观格式，否则制表符会被替换成多余空格
Python pandas.to_html() 容易忽略 encoding 和 escape 参数
用 pandas.read_sql() 拿到数据后调 to_html() 很方便，但默认行为在中文和特殊字符上容易翻车。
- 导出乱码？必须指定
encoding='utf-8'写文件，且 HTML meta 里要同步声明：<meta charset="utf-8"> - 字段含 HTML 字符（如
<script></script>或引号）？默认escape=True会转义成<script>，若想原样显示，得设escape=False，但务必确保数据可信，否则有 XSS 风险 - 不想带索引列？加参数
index=False；需要表头样式？传classes='table table-striped'，但 class 名不会自动引入 CSS，得自己配 style 标签或外链
导出大结果集时，HTML 不是合适载体
超过 5000 行、带富文本字段的查询，生成的 HTML 文件动辄几 MB，浏览器打开卡死，Excel 打不开，打印错页——这不是导出逻辑的问题，是载体选错了。
- 替代方案优先级：CSV > Excel (.xlsx) > PDF > HTML
- 真要 HTML，必须分页：用
LIMIT+OFFSET分批查，每页生成独立 HTML，或用 JS 分页（但数据仍得全加载） - 如果只是给内部同事看，不如起个轻量 HTTP 服务（比如 Flask 单文件），用
render_template_string动态渲染，查多少显多少，不落地文件
HTML 导出最常被当成“快速分享”的捷径，但它既不便于二次处理，也不适合结构化消费。只要下游不是明确要嵌入网页展示，就该立刻切到 CSV 或数据库直连。
立即学习“前端免费学习笔记（深入）”；
