Word不支持直接插入HTML源码渲染，但可通过三种方式处理：一是PasteSpecial以HTML格式粘贴（需剪贴板含有效HTML）；二是InsertFile插入本地HTML文件（稳定兼容）；三是用python-docx+lxml解析后逐元素构造（定制化强）。
Word 本身不支持直接“插入 HTML 源码”并渲染执行，但能以两种实质不同的方式处理 HTML 内容：一种是把 HTML 当作纯文本粘贴（显示为代码），另一种是让 Word 解析 HTML 结构并还原为可编辑的格式（如标题、列表、表格）。关键区别在于你想要“看代码”，还是“用内容”。
用 PasteSpecial 粘贴 HTML 格式内容（推荐用于富文本导入）
这是最接近“插入网页格式”的做法：把已有的 HTML 字符串或剪贴板里的 HTML 内容，按语义还原成 Word 元素。适用于从富文本编辑器、邮件正文、网页抓取内容导入。
- 必须先将 HTML 内容复制到系统剪贴板（例如用 Python 写入剪贴板，或浏览器中
Ctrl+C一段网页） - 在 Word 中定位光标位置，调用
Range.PasteSpecial并指定WdPasteDataType.wdPasteHTML - 常见失败原因是剪贴板里没有有效 HTML 格式数据——Word 不接受手动输入的
<p>xxx</p>字符串直接调用该方法 - 若用 VBA 或 C# 自动化，需确保剪贴板设置正确：
DataObject设置SetText后再用PutInClipboard，不能只写字符串
用 InsertFile 插入本地 HTML 文件（稳定、兼容性好）
比 PasteSpecial 更可靠，尤其适合程序批量生成报告场景。Word 会打开 HTML 文件，解析其 DOM 并转换为等效 Word 对象（段落、表格、内联样式基本保留）。
- 先将 HTML 字符串写入临时文件，路径必须是本地绝对路径，例如
C: empcontent.html - 调用
Range.InsertFile("C:\temp\content.html")（注意双反斜杠或原始字符串） - 该方法会继承 HTML 中的
<h1>→Word 标题样式、<ul>→项目符号、<table>→Word 表格，但 CSS 类名和部分内联样式（如transform）会被忽略 - 图片路径如果是相对路径，需确保 HTML 文件与图片在同一目录，否则插入后图片丢失
用 python-docx + lxml 解析 HTML 后逐元素构造（适合定制化控制）
如果你需要完全绕过 Word 的解析逻辑，比如过滤特定标签、重写链接、统一字体、跳过脚本/注释，就得自己解析 HTML 并映射到 python-docx API。
立即学习“前端免费学习笔记（深入）”；
-
lxml.html.fromstring(html_content)解析后，用 XPath 提取//body/*或//p|//h1|//table - 对每个节点类型做分支处理：
<h1>→document.add_heading(text, level=1)；<table>→ 手动创建document.add_table()并填单元格 - 无法自动还原 CSS 样式，
style="color:red"这类需手动提取并调用run.font.color.rgb = RGBColor(255,0,0) - 不支持 HTML 中的 JavaScript、iframe、canvas 等交互元素，这些会被静默丢弃
别踩坑：Word 自带“打开 HTML 文件”不是插入，而是新建文档
很多人误以为在 Word 中“文件 → 打开 → 选 index.html”就算插入成功，其实这只是新建一个文档并加载 HTML 内容，跟当前文档无关。真正插入必须通过 InsertFile、PasteSpecial 或 API 的 add_paragraph().append_html()（如 Spire.Doc）这类方法。
另外，WPS 和旧版 Word（2007/2010）对 HTML5 标签（如 <section>、<article>）支持极弱，会直接忽略或转为空段落——如果源 HTML 来自现代框架，务必先用 BeautifulSoup 预处理降级为语义明确的 <div class="section"> 形式。
