我之前处理PPT模板的时候也碰到过一模一样的问题，这个错误大概率是python-pptx的版本bug，或者你的PPT模板里的占位符格式不标准导致的，给你几个可行的解决步骤：

1. 优先更新python-pptx到最新版 #

旧版本的python-pptx在处理某些特殊图片占位符时确实存在这个sha1相关的bug，先执行更新命令：

pip install --upgrade python-pptx

更新后再跑一遍你的代码，很多时候这个问题就直接解决了。

2. 检查PPT模板的占位符是否标准 #

如果更新后还是报错，那可能是你模板里的图片占位符不是PowerPoint原生创建的标准占位符。比如有些用户会手动插入图片后再设置成占位符，或者模板是从其他格式转换过来的，这种非标准占位符会让python-pptx解析出错。

解决方法：打开你的template.pptx，删掉第4张幻灯片的旧占位符，重新通过插入 -> 占位符 -> 图片来创建标准的图片占位符，保存后再用代码测试。

3. 加异常捕获定位问题占位符 #

如果不想重新做模板，你可以给代码加个异常捕获，找出到底是哪个占位符出了问题，同时避免程序直接崩溃：

from pptx import Presentation
prs = Presentation('template.pptx')
slide4 = prs.slides[3]

for shape_idx, shape in enumerate(slide4.placeholders):
    try:
        print('%d %s' % (shape.placeholder_format.idx, shape.name))
    except AttributeError as e:
        print(f"⚠️ 处理第{shape_idx}个占位符时出错: {e}")

通过这个输出你能定位到有问题的占位符，要么删掉它，要么重新创建这个占位符。

4. 递归遍历嵌套占位符 #

有些时候，图片占位符是嵌套在“内容占位符”里面的，直接遍历slide4.placeholders可能会漏掉或者解析出错，这时候可以试试递归遍历所有形状：

from pptx import Presentation

def scan_placeholders(shape):
    try:
        if shape.is_placeholder:
            print(f"占位符索引: {shape.placeholder_format.idx}, 名称: {shape.name}")
        # 如果当前形状包含子形状（比如内容占位符），递归遍历
        if hasattr(shape, 'shapes'):
            for sub_shape in shape.shapes:
                scan_placeholders(sub_shape)
    except AttributeError as e:
        print(f"处理形状时出错: {e}")

prs = Presentation('template.pptx')
slide4 = prs.slides[3]
for shape in slide4.shapes:
    scan_placeholders(shape)

补充说明 #

这个'sha1'错误本质是python-pptx在解析PPT的XML结构时，某些非标准占位符的XML节点缺少了必要的属性，导致内部在计算哈希值的时候找不到对应的对象，从而抛出AttributeError。所以优先从版本和模板规范性入手解决，一般都能搞定。

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