使用python-pptx替换PPT演示者备注内容遇阻求助

你的代码能正常替换幻灯片正文，但演示者备注的替换功能失效，核心问题有两个：获取演示者备注的方式错误，以及替换逻辑没有适配备注文本的段落/Run结构。下面是修正后的完整代码和关键说明：

修正后的代码 #

from pptx import Presentation

prs = Presentation('templates/template_python.pptx')

# 替换键值对字典
replacements = {
    'client_name': 'example',
    'date_range': '2023-01-01 to 2023-01-30',
    'country_abb': 'CN',  # 请确保此处country变量已提前定义，示例用'CN'代替
}

# 封装通用的文本框替换逻辑，同时适配正文和备注
def replace_text_in_text_frame(text_frame, replacements):
    for match, replacement in replacements.items():
        replacement_str = str(replacement)
        for paragraph in text_frame.paragraphs:
            # 拼接段落所有Run的文本，检查是否包含要替换的关键词
            whole_text = "".join(run.text for run in paragraph.runs)
            if match not in whole_text:
                continue
            # 执行替换
            new_text = whole_text.replace(match, replacement_str)
            # 清理当前段落除第一个Run外的所有内容，避免格式混乱
            for idx, run in enumerate(paragraph.runs):
                if idx != 0:
                    paragraph._p.remove(run._r)
            # 将替换后的文本写入第一个Run
            if paragraph.runs:
                paragraph.runs[0].text = new_text

# 处理幻灯片正文（保留原有逻辑并优化）
for slide in prs.slides:
    for shape in slide.shapes:
        if shape.has_text_frame:
            replace_text_in_text_frame(shape.text_frame, replacements)

# 处理演示者备注（核心修正部分）
for slide in prs.slides:
    # 获取当前幻灯片的备注页，不存在则自动创建
    notes_slide = slide.notes_slide
    # 获取备注的文本框对象
    notes_text_frame = notes_slide.notes_text_frame
    if notes_text_frame:
        replace_text_in_text_frame(notes_text_frame, replacements)

# 保存修改后的PPT
prs.save('templates/updated_template.pptx')

关键修正说明 #

1. 正确获取演示者备注
   原代码遍历slide.shapes找notes_text_frame是错误的——演示者备注不属于幻灯片的形状集合，而是通过slide.notes_slide获取备注页对象，再通过notes_slide.notes_text_frame拿到备注的文本框，这是python-pptx访问备注的标准方式。

2. 统一替换逻辑
   将正文替换的逻辑封装成通用函数replace_text_in_text_frame，同时用于正文和备注的文本框处理，既避免重复代码，也能正确处理文本的段落和Run结构，不会丢失原有格式（如字体、颜色等）。

3. 修复潜在报错点
   原代码中country变量如果未提前定义会直接报错，示例中用'CN'代替，实际使用时请确保该变量已正确赋值。

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