如何使用Python在现有Word文档的指定位置插入图片？

首先澄清一个常见认知误区：python-docx“仅能在文档末尾插入图片”的限制，本质是对库的对象层级调用不熟悉导致的。不需要完全推翻现有工作流，也不用等待docx-mailmerge的待开发功能，现有技术栈完全可以落地定点插图的需求，具体实现路径如下：

适配现有python-docx + docx-mailmerge工作流的零成本实现 #

• 核心逻辑：Document.add_picture()、顶层Paragraph.add_picture()方法确实是在文档末尾新增段落插入图片，但库内置的Run对象（Word文档最小的内容渲染单元）原生支持add_picture方法——只要定位到目标插入位置对应的Run节点，就能把图片嵌入到文档任意位置，包括段落中间、表格单元格、甚至页眉页脚区域。
• 与现有mailmerge流程打通的步骤：
  1. 在Word模板中，需要插入图片的位置沿用已经在用的合并域做标记，给图片类的合并域加统一前缀（比如img_）做类型区分；
  2. 运行mailmerge流程时，遍历到这类带img_前缀的合并域，直接跳过原有的文本填充逻辑，拿到该合并域所在的Run节点，清空域标记文本后，调用Run对象的add_picture()方法传入图片路径、尺寸参数即可；
  3. 整套流程和你现有处理文本、表格合并的逻辑完全兼容，不需要改动已经跑通的核心代码。
• 基础实现示例：

from docx import Document
from docx.shared import Inches
doc = Document("your_existing.docx")
# 匹配之前预留的图片占位合并域，定位目标段落
target_para = next(para for para in doc.paragraphs if "img_product_pic" in para.text)
# 清空占位文本，新建Run承载图片内容
target_para.clear()
img_run = target_para.add_run()
# 图片直接插入到原占位符的位置，无额外位置偏移
img_run.add_picture("product_01.jpg", width=Inches(3.5))
doc.save("output.docx")

• 高精度定位技巧：如果文档存在动态文本修改、无法通过固定文本匹配定位位置，可以直接在Word模板对应位置插入书签，python-docx可以直接读取书签节点的位置，在书签的精确光标坐标处插入图片，定位精度远高于文本匹配方式。

低迁移成本的替代类库方案 #

如果不想自行修改mailmerge的遍历逻辑，可以选择和现有使用习惯匹配度高的类库快速实现：

• python-docx-template：基于python-docx二次封装的模板渲染库，原生支持占位符定点插图。只要在Word模板对应位置写好占位符标记，运行时直接传入图片路径或二进制流，就能自动在占位符位置插入图片，整体使用逻辑和docx-mailmerge高度相似，迁移成本极低。
• docxcompose：支持直接操作Word底层OOXML节点的工具库，可以把包含目标图片的临时文档片段，精准插入到目标文档的任意节点位置，适合处理带复杂排版、需要高精度定位的长文档场景。

内容的提问来源于stack exchange，提问作者dasboth