HTML表格转Excel必须生成符合.xlsx规范的二进制文件，可行方案仅有三条：前端用SheetJS、Python用pandas.read_html、后端用openpyxl或spire.xls；直接改后缀或伪造MIME均会失败。
HTML表格转Excel不是改个后缀名就能用的事，必须生成符合.xlsx规范的二进制文件。真能用、少踩坑的路只有三条：前端用SheetJS、Python用pandas.read_html、后端用openpyxl或spire.xls——其他“伪Excel”方案在现代Excel里基本打不开或丢格式。
为什么直接写HTML + .xls后缀会失败
Excel 2003兼容模式（.xls）本质是OLE复合文档，不是纯HTML；把<table>套个<html>标签再改后缀，Excel会报“文件已损坏”或自动跳转到浏览器打开。Chrome/Firefox近年已禁用data:application/vnd.ms-excel这类MIME伪造方案，IE/Edge也逐步弃用。
- 错误现象：
Excel无法打开文件“xxx.xls”，因为文件格式或扩展名无效 - 根本原因：没生成真正的OOXML结构（即.xlsx底层ZIP包里的
[Content_Types].xml、xl/workbook.xml等） - 临时 workaround（仅限内部低要求场景）：强制用IE内核打开，加
<meta http-equiv="content-type" content="text/html;charset=utf-8">，但中文仍易乱码
前端导出必须用SheetJS的table_to_sheet
别手写base64拼HTML模板——那只是骗老版本IE的临时补丁，现在连WPS都常报错。SheetJS是目前唯一被Excel官方文档间接承认的前端xlsx生成库。
- 关键约束：
table节点必须含完整<thead>和<tbody>，否则列数错位、标题丢失 - 别传
document.body，只传目标tableDOM节点，例如document.getElementById('report-table') - 合并单元格支持有限：需提前在HTML里用
rowspan/colspan，SheetJS能识别但不支持动态计算 - 大表卡顿？加
loading状态，5000行以上建议切分或走后端
Python用pandas.read_html最省事
本地HTML文件或已渲染完的字符串，pandas.read_html是最快路径。它底层调用lxml解析，自动提取所有<table>并转为DataFrame列表。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
立即学习“前端免费学习笔记（深入）”；
- 必选参数：
parser='lxml'（比默认html.parser更准，尤其嵌套复杂时） - 中文乱码？读文件时加
encoding='utf-8'；如果是HTTP响应，确保Content-Type头带charset=utf-8 - JS渲染的表格？先用Playwright/Selenium截图或获取
page.content()，再喂给read_html - 示例：
df = pd.read_html('data.html', parser='lxml')[0]; df.to_excel('out.xlsx', index=False)
后端生成适合正式系统但要注意响应头
用户上传HTML、权限校验、审计日志、大数据流式导出——这些必须后端做。但导出接口返回的不是HTML，而是application/vnd.openxmlformats-officedocument.spreadsheetml.sheet二进制流。
- 关键配置：响应头必须设
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，且Content-Disposition: attachment; filename="xxx.xlsx" - 编码陷阱：用
openpyxl写入中文时，单元格值无需额外encode，但字体要显式设font = Font(name='微软雅黑')才不方块 - 性能红线：单次导出超10万单元格（≈5k行×20列），建议分Sheet或启用
write_only=True模式 -
spire.xls虽支持HTML字符串直转，但它是商业库，免费版有水印和行数限制
真正麻烦的从来不是“怎么导”，而是表格里有没有colspan/rowspan、有没有JS动态插入的<tr>、Excel打开后日期是不是变成数字——这些细节决定你花2小时还是2天收工。
