Word无法解析HTML图片主因是其对img标签支持极弱，仅接受同级或子目录的无协议绝对路径（如images/logo.png），不支持file://、data:、相对路径及上级跳转；需改用嵌入方式插入图片或通过python-docx等工具绕过HTML解析。
Word 打开含 HTML 图片的文档报错，大概率不是图片本身问题，而是 Word 在解析 file:///C:/xxx/xxx.png）失败，或权限被系统/安全策略拦截。
查 src 路径是否含非法协议或相对路径乱跳
Word 对 HTML 片段中 file://、data: 或纯相对路径（如 ./pic.png），也不处理上级目录跳转（../）。
- 错误写法：
- 错误写法：
- 正确做法：用绝对路径指向当前文档同级或子目录下的文件，且去掉协议头，仅保留类似
pic.png或images/logo.png - 验证方式：把 HTML 片段粘贴进记事本，另存为
test.html，双击用浏览器打开——能显示 ≠ Word 能接受
插图前先「嵌入」而非「链接」到 Word 文档内部
直接往 Word 里粘贴 HTML，本质是让 Word 尝试渲染该片段；但它的 HTML 支持极弱，尤其对资源引用。更稳的方式是绕过 HTML 解析，把图片真正塞进文档。
- 手动操作：复制图片 → 切换到 Word →
Ctrl+V（不是粘贴 HTML，是粘贴图像对象） - 批量场景：用 Python +
python-docx，读取图片二进制后调用paragraph.add_run().add_picture()，完全避开 HTML - 切忌用
docx.Document().add_paragraph().add_run().add_text('—— 这只是插入字符串，不是渲染 HTML')
检查 Windows 应用容器权限（尤其 Win11 / 教育版 / 组策略锁死环境）
某些系统配置会让 Word 在沙箱中运行，禁止其访问本地文件路径，哪怕路径语法合法也会静默失败，报错可能是 无法加载图片 或直接卡在「正在插入…」不动。
立即学习“前端免费学习笔记（深入）”；
- 现象：同一份文档，在同事电脑上正常，在你电脑上插图就崩 → 优先怀疑权限隔离
- 临时验证：右键 Word 快捷方式 → 「以管理员身份运行」→ 再试插入 → 若成功，说明是 UAC 或应用容器限制
- 长期解法：组策略中检查
计算机配置 → 管理模板 → Windows 组件 → Microsoft Office 2016/2019/365 → 安全设置 → 启用受保护的视图是否强制开启；关闭它可能缓解，但需权衡安全
最麻烦的情况是：HTML 是从外部系统（比如报表引擎）自动生成的，你没法改输出逻辑。这时候别硬调 Word 的 HTML 渲染，老老实实加一层转换——把 python-docx 或 VBA 插进去。路径和权限问题，从来不是 Word 单方面的问题，而是 HTML 生成方、落地路径、宿主权限三者没对齐。
