如何使用python-docx替换Word文档表格中的图片？

阿华AIGC实验室

2026-5-29

如何用Python替换Word表格单元格中的图片？

你遇到的问题其实很常见——原来的代码只是在目标单元格里新增了一张图片，并没有移除掉已有的旧图片，所以看起来替换没生效。别担心，不管是用python-docx还是其他工具，都能实现替换操作，我给你拆解两种可行的方案：

方案一：用python-docx实现（跨平台）

python-docx本身没有直接的“替换图片”方法，但我们可以先删除单元格里的旧图片（或者清空整个单元格内容），再添加新图片。

方式1：清空单元格所有内容再添加新图

如果单元格里只有图片，不需要保留其他文本，这种方式最简单直接：

from docx import Document
from docx.shared import Inches

# 打开文档
doc = Document('myWordDoc.docx')
# 定位到目标单元格（第一个表格的第一行第一列）
target_cell = doc.tables[0].rows[0].cells[0]

# 清空单元格内的所有内容（包括旧图片）
for paragraph in target_cell.paragraphs:
    for run in paragraph.runs:
        run.clear()
# 也可以用更彻底的方式删除所有段落
# while target_cell.paragraphs:
#     p = target_cell.paragraphs[0]
#     p._element.getparent().remove(p._element)

# 添加新图片到单元格
new_paragraph = target_cell.add_paragraph()
run = new_paragraph.add_run()
run.add_picture('/tmp/foo.jpg', width=Inches(2.5))

# 保存修改后的文档
doc.save('updated_myWordDoc.docx')

方式2：精准删除图片，保留其他文本

如果单元格里除了图片还有需要保留的文字，可以精准定位并删除包含图片的run：

from docx import Document
from docx.shared import Inches

doc = Document('myWordDoc.docx')
target_cell = doc.tables[0].rows[0].cells[0]

# 遍历单元格内的段落，找出包含图片的run并删除
for paragraph in target_cell.paragraphs:
    # 先收集要删除的run，避免遍历过程中修改列表导致异常
    runs_to_remove = []
    for run in paragraph.runs:
        # 检查run是否包含图片
        if run.inline_shapes:
            runs_to_remove.append(run)
    # 移除包含图片的run
    for run in runs_to_remove:
        paragraph._element.remove(run._element)

# 添加新图片
new_paragraph = target_cell.add_paragraph()
run = new_paragraph.add_run()
run.add_picture('/tmp/foo.jpg', width=Inches(2.5))

doc.save('updated_myWordDoc.docx')

方案二：用win32com.client（仅Windows）

如果你的运行环境是Windows，且需要更贴近Word原生操作的功能，可以用win32com.client直接调用Word的COM接口，这种方式处理复杂场景更可靠：

import win32com.client as win32
from docx.shared import Inches

# 启动Word后台进程
word = win32.gencache.EnsureDispatch('Word.Application')
word.Visible = False  # 不显示Word窗口，后台运行
doc = word.Documents.Open('myWordDoc.docx')

# 定位目标单元格（注意win32com的索引是从1开始的）
table = doc.Tables(1)
target_cell = table.Cell(Row=1, Column=1)

# 删除单元格内的所有图片
for shape in target_cell.Range.InlineShapes:
    shape.Delete()

# 添加新图片，这里需要把Inches转换为Word的点数（1英寸=72点数）
target_cell.Range.InlineShapes.AddPicture(
    Filename='/tmp/foo.jpg',
    LinkToFile=False,
    SaveWithDocument=True,
    Width=Inches(2.5) * 72
)

# 保存并关闭
doc.SaveAs('updated_myWordDoc.docx')
doc.Close()
word.Quit()