如何用Python（python-pptx/pywin32）编辑PowerPoint中的注释？

以下是两种可行的实现方案，覆盖不同使用场景：

方案一：通过pywin32操控PowerPoint COM对象（Windows环境） #

PowerPoint的COM对象中，注释的文本内容并非直接通过Comment.Text属性修改，而是需要访问注释的TextFrame.TextRange，再通过其中的Run对象处理超链接。

代码示例 #

import win32com.client as win32

# 初始化PowerPoint应用
ppt_app = win32.gencache.EnsureDispatch('PowerPoint.Application')
# 打开目标演示文稿（使用绝对路径）
presentation = ppt_app.Presentations.Open(r'C:\example\your_file.pptx')

# 遍历所有幻灯片
for slide in presentation.Slides:
    # 遍历当前幻灯片的所有注释
    for comment in slide.Comments:
        # 获取注释的文本框对象
        text_frame = comment.TextFrame
        # 遍历文本框中的段落
        for para in text_frame.TextRange.Paragraphs:
            # 遍历段落中的文本片段（Run）
            for run in para.Runs:
                # 检查当前片段是否包含超链接
                if run.Hyperlink.Address != '':
                    # 替换超链接显示文本
                    run.Text = "替换后的链接文本"
                    # 替换超链接目标URL
                    run.Hyperlink.Address = "https://your-new-url.com"

# 保存修改并关闭
presentation.Save()
presentation.Close()
ppt_app.Quit()

关键说明 #

• 注释的文本内容和超链接都嵌套在TextRange的Run对象中，每个Run对应一段连续格式的文本
• Hyperlink.Address直接对应超链接的目标URL，修改后即时生效

方案二：直接修改PPTX压缩包内的XML文件（跨平台） #

PPTX本质是ZIP压缩包，注释内容存储在ppt/slides/slideX.xml中，超链接的目标URL则对应ppt/slides/_rels/slideX.xml.rels里的关系项。可以通过解析XML直接修改内容。

代码示例 #

import zipfile
import os
import xml.etree.ElementTree as ET
from tempfile import TemporaryDirectory

# 定义PPTX的XML命名空间
NS_MAP = {
    'p': 'http://schemas.openxmlformats.org/presentationml/2006/main',
    'a': 'http://schemas.openxmlformats.org/drawingml/2006/main',
    'r': 'http://schemas.openxmlformats.org/officeDocument/2006/relationships'
}

def update_comment_links(source_pptx, old_url, new_url, new_link_text):
    with TemporaryDirectory() as temp_dir:
        # 解压PPTX到临时目录
        with zipfile.ZipFile(source_pptx, 'r') as zip_ref:
            zip_ref.extractall(temp_dir)
        
        slides_dir = os.path.join(temp_dir, 'ppt', 'slides')
        # 遍历所有幻灯片XML文件
        for filename in os.listdir(slides_dir):
            if not filename.startswith('slide') or not filename.endswith('.xml'):
                continue
            
            slide_path = os.path.join(slides_dir, filename)
            tree = ET.parse(slide_path)
            root = tree.getroot()
            
            # 查找当前幻灯片中的所有注释
            comments = root.findall('.//p:cm', NS_MAP)
            for comment in comments:
                # 查找注释中的所有文本片段
                runs = comment.findall('.//a:r', NS_MAP)
                for run in runs:
                    # 检查是否包含超链接
                    hlink_node = run.find('.//a:hlinkClick', NS_MAP)
                    if hlink_node is None:
                        continue
                    
                    # 修改链接显示文本
                    text_node = run.find('.//a:t', NS_MAP)
                    if text_node is not None:
                        text_node.text = new_link_text
                    
                    # 修改对应rels文件中的目标URL
                    rel_id = hlink_node.get(f'{{{NS_MAP["r"]}}}id')
                    rels_filename = f"{filename}.rels"
                    rels_path = os.path.join(slides_dir, '_rels', rels_filename)
                    
                    if os.path.exists(rels_path):
                        rel_tree = ET.parse(rels_path)
                        rel_root = rel_tree.getroot()
                        # 找到对应ID的关系项并修改Target
                        for rel in rel_root.findall('.//r:Relationship', NS_MAP):
                            if rel.get('Id') == rel_id and rel.get('Target') == old_url:
                                rel.set('Target', new_url)
                                rel_tree.write(rels_path, encoding='utf-8', xml_declaration=True)
            
            # 保存修改后的幻灯片XML
            tree.write(slide_path, encoding='utf-8', xml_declaration=True)
        
        # 重新打包为新的PPTX
        output_pptx = os.path.splitext(source_pptx)[0] + '_updated.pptx'
        with zipfile.ZipFile(output_pptx, 'w', zipfile.ZIP_DEFLATED) as zip_out:
            for root_dir, subdirs, files in os.walk(temp_dir):
                for file in files:
                    file_path = os.path.join(root_dir, file)
                    arcname = os.path.relpath(file_path, temp_dir)
                    zip_out.write(file_path, arcname)
    
    print(f"修改完成，输出文件: {output_pptx}")

# 使用示例
update_comment_links('your_presentation.pptx', 'https://old-target-url.com', 'https://new-target-url.com', '新链接文本')

关键说明 #

• 需要处理XML命名空间，否则无法正确定位节点
• 超链接的目标URL存储在关系文件（.rels）中，必须对应修改才能生效
• 该方法无需依赖PowerPoint客户端，支持跨平台使用

内容的提问来源于stack exchange，提问作者Владислав Стадник