关于 Excel 转 HTML 工具
Excel 转 HTML 工具基于 SheetJS 库在浏览器本地将 xlsx、xls 电子表格转换为带样式的 HTML 表格。转换过程保留单元格数据类型、合并单元格（colspan 和 rowspan）、对齐方式和基本格式信息，生成语义化的 table、thead、tbody 结构。输出的 HTML 表格自带响应式样式，可直接嵌入网页、邮件模板或文档系统。支持工作表选择和自定义 CSS 类名，便于与现有站点样式系统集成。理解转换的边界很重要：工作表里的内嵌图片、图表、条件格式和超复杂字体样式并不会转成表格内容，真正保留下来的是单元格的数据值、合并布局和粗略的对齐风格，所以它最擅长的是"把一张结构化数据表变成可在网页里展示的长表格"。若源表含公式，建议先确认计算结果为预期数值再转换，因为 SheetJS 读取的是计算后的结果而非公式本身。配合自定义类名能更快融入现有站点的视觉规范，省去二次调整样式的时间。
合并单元格是导出的第一道坎。表格工具里合并只影响显示，单元格本身仍各自存在，被合并覆盖的那些格子通常是空值；而网页表格需要用跨行与跨列属性来表达合并，若导出时忽略这层映射，合并区域会退化成一堆空格，结构信息就此丢失。处理前应先确认源表是否存在合并，并对合并区域做一次显式映射。
样式与内容需要分开处理，这是第二个容易被忽略的边界。表格里常见的背景色、边框与条件格式在网页表格里没有直接对应，导出时通常只保留单元格的值。若下游需要保留观感，正确做法是导出结构化数据再由样式表统一渲染，而不是把格式硬编码进标记——后者的维护成本会随着改版迅速上升。
与导出为纯数据格式相比，网页表格的优势是「可读且可直接嵌入」：粘贴进文档或邮件即可展示，不需要接收方有表格软件。代价是体积较大，且当行列数量很多时生成的文件会明显膨胀。因此它适合作为展示用产物，而需要继续计算或统计的场景应选择数据格式，两者的选择标准是「下游是否还要处理数字」。
转义是安全上的关键一环。单元格内容里若含尖括号、与号或引号，未经转义直接写入标记会被解析成标签，轻则显示错乱，重则在展示页面时构成注入风险。因此导出流程必须做一次字符转义，并在导出后抽查含特殊字符的单元格，确认内容以文本形式呈现而不是被当作标记。
最后，行列顺序与表头处理需要在流程里固定。是否把首行当作表头、是否保留隐藏行列、以及是否需要为表格补充标题与说明，这些决定会让同一份数据产生完全不同的产物。把这些选项写进导出说明，能让接收方理解产出的依据，也避免因为口径不同而在后续沟通中反复确认。
当表格很大时，产出的网页表格需要额外的浏览设计。几十行以上的表格若一次性铺开，读者要靠横向滚动才能看全，体验会迅速下降；此时应改为固定表头、允许纵向滚动，或提供导出与检索入口。判断标准是「读者是需要通读全部，还是只需要确认其中几行」，后者更适合做成可筛选的视图而不是完整铺开的静态表格。
这与表格软件里的「另存为网页」并不等价，值得区分清楚。软件的导出通常带一整套附带样式与脚本，体积大且难以并入现有页面；而按数据导出再自行渲染得到的是干净的表格标记，可以直接嵌进既有版式。因此需要嵌入到已有站点时，应当选择后一条路线，把样式控制权留给自己。
实现原理
转换把单元格映射成表格结构，因此行列对应关系由表格本身决定，合并单元格是最需要处理的例外——合并跨越多个行列时，HTML 表格要用跨行与跨列属性表达，而合并区域在其它单元格上表现为空值，直接输出会丢结构。此外富文本格式会丢失，只保留单元格的值。
A1:C1 合并的标题行<th colspan="3">（用跨列属性表达；被覆盖的 B1、C1 在源数据里是空值）本页实测数据
| 修复：CSV 中文乱码 | 旧实现把 CSV 字节数组交给 SheetJS（type:'array'），它逐字节按 CP1252 映射 → 「北京」变成 å京。改为文本类文件先解码成字符串再解析：UTF-8 严格模式优先，失败回退 GB18030（老版中文 Excel 导出的 CSV 多为 GBK），并剥掉 BOM |
|---|---|
| 结构正确 | 3 行（表头 + 2 行数据）× 3 列 = 9 个单元格 |
| 转义 | 单元格里的 a<b>&c 输出为 <b> 等实体，无裸标签注入（表格内不执行脚本） |
| 片段合法 | 只注入 <table>…</table>，不带 <html>/<meta>/<title>——旧实现在 div 里塞 meta/title 形成无效 DOM，实现注释已记录该修复 |
| 表头语义 | 首行作为表头渲染（<td> 带 data-t/data-v 属性，xlsx 库的 sheet_to_html 产出） |
两个容易忽略的坑：①CSV 编码——中文 CSV 有 UTF-8（含/不含 BOM）与 GBK/GB18030 两大流派，直接按字节交给解析库最常见的结果是 mojibake（北京 → å京 这种拉丁扩展字符）；②注入合法性——SheetJS 的 sheet_to_html 返回的是完整 HTML 文档，把整段塞进 v-html 会把 meta/title 塞进 div 里形成无效 DOM，必须只取 table 片段。另外 xlsx 里的合并单元格、公式、日期格式在 HTML 表格里会退化为文本/空值，需要保真请直接看原表。
使用方法
- 打开「Excel 转 HTML 工具」
- 导入或粘贴待处理的数据
- 根据需要调整输出选项
- 点击「处理」按钮，结果实时显示
- 复制或导出结果
使用场景
- 网页数据发布 — 将 Excel 报表转为 HTML 表格直接嵌入公司内网或 CMS 系统展示。
- 邮件模板制作 — 把 Excel 中的产品价格表转为 HTML 表格嵌入营销邮件，兼容各邮件客户端。
- 文档系统导入 — 将 Excel 数据表转为语义化 HTML 结构，导入 Confluence 或 Notion 等文档平台。
- 数据预览展示 — 将 Excel 数据转为 HTML 表格快速预览，无需安装 Excel 软件即可查看内容。
- 报表自动化 — 将定期生成的 Excel 报表转为 HTML 嵌入仪表盘页面，实现自动化数据展示。
- 静态站点发布 — 把多站点通用的报价或目录表转成 HTML 静态段落，避免每个页面单独校对。
常见问题
转换后保留合并单元格吗？
保留。工具会将 Excel 中的合并单元格转换为 HTML 的 colspan 和 rowspan 属性，保持表格布局一致。
输出的 HTML 能直接用吗？
能。生成的 HTML 包含语义化 table、thead、tbody 结构和基本样式，可直接粘贴到网页或邮件编辑器中使用。
支持自定义样式吗？
支持。可自定义 CSS 类名替换默认样式，也支持修改对齐方式、边框和背景色等表格属性。
能处理含公式的单元格吗？
能。SheetJS 会读取公式的计算结果值而非公式本身，转换后的 HTML 表格显示的是计算后的数值。
内嵌图片或图表能转换吗？
不能。工作表里的图片、内嵌图表、条件格式等富对象不会转成表格内容，只保留数据值、合并与对齐等基本结构。
文件会被上传吗？
不会。所有解析和转换在浏览器本地通过 SheetJS 完成，文件不离开你的设备，可安全处理含敏感数据的报表。
生成的 HTML 表格在网页里样式很丑？
工具输出语义化的 <table> 结构（thead/tbody），不含样式，方便你套自己的 CSS。需要好看的样式时，套一个表格样式类或引入轻量 CSS；直接复制到富文本编辑器（如公众号后台）会继承编辑器默认样式，效果通常可接受。
合并单元格转换后结构不对？
HTML 用 rowspan/colspan 表达合并，转出来会带这两个属性；如果目标是纯数据表格，建议先在 Excel 里取消合并再导出。需要保留合并视觉时，确认工具输出里保留了 rowspan/colspan，浏览器即可正确渲染。