html-docx-js适合浏览器端快速导出，支持canvas转图但无页眉页脚；html-to-docx返回buffer、支持高级排版配置但需手动处理样式和图片，二者均不依赖第三方服务器。
直接用 html-doc-js 或 html-to-docx 是最可控、可集成、不传文件到第三方的方案；在线转换器和 Word 打开再另存虽快，但样式错乱、表格边框丢失、中文排版崩坏是常态。
选哪个库？html-doc-js vs html-to-docx
两者都支持浏览器端导出，但行为差异明显：
-
html-doc-js不生成 Buffer，直接触发下载，适合 Vue/React 项目内嵌调用；它把 CSS 转成行内 style，对border-collapse、padding等兼容较好，但不支持页眉页脚、分节符等 Word 高级特性 -
html-to-docx返回Buffer，需配合FileSaver.js触发下载，支持header/footer/pageNumber等配置，但默认会忽略style标签里的规则，必须手动提取并注入 - 若页面含 MathJax 公式或
canvas图表，html-doc-js的toImg参数能一键转图；html-to-docx需自己先用html2canvas截图再替换 DOM
DOM 导出前必须清理的 3 类节点
不清理就导出，Word 里大概率出现空白块、重复文字、错位公式：
- 所有
mjx-assistive-mml元素（MathJax 辅助节点），用document.querySelectorAll('mjx-assistive-mml').forEach(el => el.remove())干掉 - 所有
script和link标签，它们不会被渲染，但可能干扰解析逻辑 - 带
display: none或visibility: hidden的容器，html-doc-js默认仍会导出其子内容，得提前remove()
CSS 写法直接影响 Word 渲染效果
Word 对 CSS 支持极弱，以下写法在网页看着正常，导出后基本失效：
- 用
px单位 → 改成pt（例如font-size: 12pt） - 用 CSS 变量（
--main-color）→ 必须预编译为具体值，html-doc-js不解析 :root - 复杂选择器如
.report > table tr:nth-child(odd)→ 改为直接给tr加 class，Word 只认行内style - 表格必须声明
border-collapse: collapse且每行每单元格加border，否则 Word 里边框全消失
导出后 Word 打开报错或格式错乱？检查这 2 点
常见错误信息是 “无法打开文件，因为内容有误” 或文字堆叠成一行：
- HTML 片段里含未闭合标签（比如漏了
），html-to-docx会静默失败，建议用DOMParser预检：new DOMParser().parseFromString(htmlContent, 'text/html')看是否抛异常 - 导出内容含非法字符（如 U+2028 行分隔符），Word 解析器会卡住，可用正则清洗：
htmlContent.replace(/[\u2028\u2029]/g, '')
真正麻烦的从来不是“能不能转”，而是“转完能不能直接交出去”。表格线断开、中文字体变成宋体五号、页边距归零——这些细节没在导出前压测过，交付时就会卡在业务方最后一关。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
