使用Python在PDF指定位置替换图片的实现方法咨询

你已经完成图片提取、匹配校验的前提下，核心要完成两个环节：提取目标图片的位置属性、插入新图片并清理冗余资源，推荐用PyMuPDF（fitz）库实现，这是目前Python处理PDF内容定位和编辑效率最高的库之一。

步骤1：获取匹配成功的图片的位置与页面属性 #

你之前提取图片时可以拿到图片对应的页码、xobj编号，在PyMuPDF中可以通过遍历页面对象的get_images()返回值匹配到你的校验结果，拿到精准位置信息：

import fitz

# 打开目标PDF文件
doc = fitz.open("待处理的原文件.pdf")
# 假设你已经拿到匹配成功的图片对应页码page_num、图片的xref编号img_xref
page = doc[page_num]
# 遍历页面所有图片元素，匹配到对应xref的图片后获取位置矩形
for img in page.get_images(full=True):
    if img[0] == img_xref:
        # 返回的fitz.Rect对象包含x0,y0（左上角坐标）、x1,y1（右下角坐标）
        img_rect = page.get_image_bbox(img)
        # 可同步获取原图片宽高、旋转角度等属性
        original_width = img_rect.width
        original_height = img_rect.height
        break

注意：如果PDF页面有旋转属性，需要先调用page.rotation_matrix对坐标做转换，避免插入位置偏移

步骤2：插入新图片并完成替换 #

拿到坐标后直接在对应位置插入新图片，可选择删除原图片资源减小文件体积：

# 插入新图片到目标位置
page.insert_image(
    img_rect,
    filename="待替换的新图片路径.png",
    keep_proportion=True  # 如果需要严格匹配原图片尺寸可以设为False
)

# 可选操作：删除原PDF中的旧图片资源，减小最终文件体积
doc._deleteObject(img_xref)

# 保存替换后的PDF文件，参数可以压缩冗余资源
doc.save("替换完成的文件.pdf", garbage=4, deflate=True)

常见注意事项 #

• 如果原PDF中的图片是内嵌在内容流里的软掩码、透明图层图片，不要直接删除原资源，否则可能导致页面内容损坏，直接覆盖插入新图片即可
• 替换的新图片如果是透明背景的PNG，insert_image会自动保留透明属性，不需要额外处理
• 批量处理多页匹配图片时，建议遍历所有页面时缓存图片xref和对应匹配结果，避免重复遍历提升效率

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