Word不解析HTML中的<img>标签，导致图片显示空白；需改用VML语法（cid协议）或Base64内联，但兼容性有限；最可靠方案是直接生成.docx文件。
Word 里 <img> 标签显示空白？HTML 转 Word 本就不支持直接渲染
HTML 文件里用 <img src="xxx.jpg"> 写的图片，在用浏览器另存为 Word 或通过 Office 打开时显示为空白——这不是路径错了，而是 Word 根本不解析 HTML 的 <img> 标签。它只把 HTML 当作一种导入格式，且仅支持极简结构（如内联 style、基础标签），<img> 默认被忽略或转成占位符。
用 <v:shape> + <v:imagedata> 才能真正嵌入图片（仅限旧版 Word 兼容模式）
若必须用 HTML 文件作为 Word 源（比如邮件模板、导出中间件），需改用 Microsoft VML（Vector Markup Language）语法，这是 Word 2003–2013 识别图片的唯一 HTML 变体：
<v:shape id="img1" o:hr="t" style="width:200px;height:150px;" type="#_x0000_t75"> <v:imagedata src="cid:myimage.jpg" o:title=""/> </v:shape>
关键点：
-
src必须是cid:协议（表示内嵌资源），不能是本地路径或 HTTP 链接 - 需配合 MIME 多部分邮件格式（multipart/related），把图片作为附件绑定到
cid，纯 HTML 文件无法独立实现 - 新版 Word（2016+）对 VML 支持变弱，可能降级为灰色方框
更可靠的做法：用 data:image/png;base64 内联图片（兼容性较好）
将图片转为 Base64 编码后写进 src，绕过路径和外部依赖：
立即学习“前端免费学习笔记（深入）”；
<img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..." width="200" height="150"/>
注意限制：
- Base64 字符串长度不能超过 Word 的单字段上限（实测建议 ≤ 1MB 图片，否则打开卡顿或截断）
- Word 2010+ 基本支持，但某些企业版策略会禁用内联数据协议（表现为图片区域全灰）
- 生成时确保换行符是
\n（非\r\n），否则 Base64 解码失败导致空白 - 不要用
<picture>或srcset，Word 完全无视
真正稳定的方案：别用 HTML 当 Word 源，改用 docx 生成库
如果目标是“在程序里动态插入图片并导出为 Word”，硬啃 HTML → Word 路径是自找麻烦。直接生成 .docx 更可控：
- Python 用
python-docx：document.add_picture('logo.png', width=Inches(2)) - Node.js 用
docx库：调用new ImageRun('path/to/img.jpg') - .NET 用
OpenXML SDK：通过DrawingsPart插入二进制流 - 所有方案都把图片作为 OOXML 包内的独立 part 存储，无路径依赖、无编码风险
HTML 只适合做内容草稿或邮件正文；一旦涉及图片、表格样式、页眉页脚，就该切换载体——Word 对 HTML 的“支持”本质是妥协式导入，不是渲染引擎。
