首页 / 新闻资讯 / Python替换Word文档中的图片：完整指南

Python替换Word文档中的图片：完整指南

发布时间：2026-08-01 作者：林涛 阅读量：15

Python替换Word文档中的图片

在日常办公中，我们经常需要批量处理Word文档，例如替换其中的图片。Python凭借其强大的第三方库 python-docx，可以轻松实现这一需求。本文将详细介绍如何利用Python替换Word文档中的图片，包括读取、定位、删除和插入新图片的完整流程。

环境准备

首先，确保已安装 python-docx 库：

pip install python-docx

另外，还需要安装 Pillow 库以便处理图片格式：

pip install Pillow

核心原理

python-docx 库将Word文档解析为一个XML结构，图片存储在 InlineShape 或 Picture 对象中。替换图片的本质是：

  1. 遍历文档中的段落和表格，找到所有的图片对象；
  2. 记录图片的位置（如段落索引、run对象）；
  3. 删除旧图片；
  4. 在相同位置插入新图片。

实战代码

以下是一个完整的示例函数，用于替换Word文档中所有图片为指定图片：

import os
from docx import Document
from docx.shared import Inches

def replace_images_in_word(doc_path, new_image_path, output_path=None):
    """
    替换Word文档中的所有图片为指定图片
    :param doc_path: 原Word文档路径
    :param new_image_path: 新图片路径（建议为PNG或JPG）
    :param output_path: 输出文档路径，默认在原文件后添加'_replaced'
    """
    doc = Document(doc_path)
    
    # 遍历所有段落
    for para in doc.paragraphs:
        for run in para.runs:
            if run._element.findall('.//' + '{http://schemas.openxmlformats.org/wordprocessingml/2006/main}drawing'):
                # 找到图片，删除其XML元素
                for img in run._element.findall('.//' + '{http://schemas.openxmlformats.org/wordprocessingml/2006/main}drawing'):
                    run._element.remove(img)
                # 在相同位置插入新图片
                run.add_picture(new_image_path, width=Inches(4), height=Inches(3))
                
    # 处理表格中的图片（类似逻辑）
    for table in doc.tables:
        for row in table.rows:
            for cell in row.cells:
                for para in cell.paragraphs:
                    for run in para.runs:
                        if run._element.findall('.//' + '{http://schemas.openxmlformats.org/wordprocessingml/2006/main}drawing'):
                            for img in run._element.findall('.//' + '{http://schemas.openxmlformats.org/wordprocessingml/2006/main}drawing'):
                                run._element.remove(img)
                            run.add_picture(new_image_path, width=Inches(4), height=Inches(3))
    
    # 保存文档
    if output_path is None:
        base, ext = os.path.splitext(doc_path)
        output_path = f"{base}_replaced{ext}"
    doc.save(output_path)
    print(f"替换完成，已保存至：{output_path}")

# 使用示例
replace_images_in_word('example.docx', 'new_image.png')

注意事项

  • 保持图片格式：新图片的尺寸和比例可能影响文档布局，请根据需求调整 width 和 height 参数。
  • 处理多种图片类型：Word中图片可能以 Drawing 或 Picture 形式存在，上述代码主要针对 Drawing 对象。
  • 批量处理：可循环调用该函数处理多个文档。

进阶：按序号替换指定图片

如果只想替换第一个或某个特定图片，可以维护一个计数器：

def replace_nth_image(doc, img_index, new_image_path):
    count = 0
    for para in doc.paragraphs:
        for run in para.runs:
            # ... 检测到图片时
            if run._element.findall('.//' + '{http://schemas.openxmlformats.org/wordprocessingml/2006/main}drawing'):
                if count == img_index:
                    # 执行替换
                    ...
                    return
                count += 1

总结

通过 python-docx 库，我们可以高效地替换Word文档中的图片，实现办公自动化。本文提供了完整的代码示例和注意事项，希望对您有所帮助。如有更多问题，欢迎在评论区交流。

相关文章