python-pptx中related_parts失效，如何遍历PPTX所有图片并关联相关信息？

问题描述 #

旧代码通过遍历shape.part.related_parts.values()识别并处理幻灯片中的图片，代码如下：

# "prs" 是PPTX演示文稿的句柄
for slide in prs.slides:
    for shape in slide.shapes:
        for relpart in shape.part.related_parts.values():
            if isinstance(relpart, pptx.parts.image.ImagePart):
                # 对每张图片执行操作

但python-pptx新版本移除了related_parts字典，改用related_part(some_id)方法，导致原有代码无法运行。需要找到受支持的替代实现，要求遍历幻灯片时能获取幻灯片编号、shape_id与图片partname的映射关系，其余逻辑与原代码一致。

解决方案 #

在新版本中，可通过访问形状的part.rels集合获取所有关联关系，每个关联项包含rId（关联ID），再用related_part(rId)方法获取对应部件。具体实现如下：

from pptx.parts.image import ImagePart

# "prs" 是PPTX演示文稿的句柄
for slide_idx, slide in enumerate(prs.slides, start=1):  # slide_idx 从1开始对应幻灯片编号
    for shape in slide.shapes:
        # 遍历形状部件的所有关联关系
        for rel in shape.part.rels.values():
            # 获取关联的部件
            part = shape.part.related_part(rel.rId)
            # 检查是否为图片部件
            if isinstance(part, ImagePart):
                # 提取所需的映射信息
                slide_number = slide_idx
                shape_id = shape.shape_id
                image_partname = part.partname
                
                # 执行原有的图片处理逻辑
                # 示例输出信息，可替换为你的操作
                print(f"幻灯片{slide_number}，形状ID{shape_id}，图片内部路径{image_partname}")
                # 你的图片操作代码...

关键细节说明 #

• enumerate(prs.slides, start=1)：从1开始计数，得到与PPT界面显示一致的幻灯片编号
• shape.part.rels.values()：获取形状部件的所有关联关系，替代原有的related_parts字典遍历
• rel.rId：每个关联项的唯一标识ID，用于调用related_part()方法获取对应部件
• shape.shape_id：形状的唯一ID，part.partname：图片在PPT内部的存储路径

该实现完全兼容新版本python-pptx的API，同时满足对幻灯片编号、shape_id和partname映射关系的需求，原有图片处理逻辑可直接嵌入对应位置执行。

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