科技 · 实用指南
PowerPoint 备注导出漏字？先核对四种状态再验收讲稿
空结果可能来自三种不同情况。通过一份受控 PPTX，我们保留全部幻灯片，并区分备注正文占位符缺失与真正的空备注。
备注导出程序顺利结束，仍可能漏掉演示文稿的一部分。验收讲稿前，应为每页记录一种结果：没有备注页、没有 BODY 正文占位符、BODY 为空，或 BODY 有文本。前两种情况不能与有意留空的备注混为一谈。
我们用原创四页 PPTX，在 Python 3.12.14 与 python-pptx 1.0.2 中测试这一边界。主动改变放映顺序后，已保存文件的幻灯片 ID 依次为 259、257、256、258，对应备注部件为 notesSlide3、无、notesSlide1、notesSlide2。按备注文件名排序无法还原该顺序。
审计保留四条记录及原有三个备注页，输入文件的 SHA-256 未变。包含逗号、引号、换行和中文的备注，经 CSV 写入再读取后逐字一致。另一次直接读取则在内存中新建了第四个备注页；对缺失 BODY 的 .text 访问触发 AttributeError。
这是受控的文本提取测试，并非 PowerPoint 渲染或修复测试。目标是在生成会议讲稿或后续数据前，弄清实际读取了什么、哪些页面需要作者确认。
按真实页序读取，保留四种结果
用 Presentation(path) 打开保留的副本，遍历 enumerate(prs.slides, 1)，同时记录当前位置与 slide.slide_id。ID 只在该演示文稿内标识页面，不能当作跨文稿的通用标识。通过幻灯片的备注关系取值，不要把 notesSlideN.xml 直接分配给第 N 页。
每页先判断 has_notes_slide；False 记为 no-notes-slide，不访问 notes_slide。否则取得 notes_slide.notes_text_frame；None 记为 no-body-placeholder；.text 等于空字符串记为 body-empty；其他字符串记为 body-text。保留原始字符串和空白字符；如需标记纯空白备注，另加标志，不要悄悄 strip。
BODY 缺失是待处理异常，不是空讲稿
BODY 占位符是备注正文的目标。备注页还可能有其他文本框与占位符。在我们的缺失 BODY 样本中，一个自定义文本框有待审信息，页码占位符有 999。审计单独列出两者的形状 ID、名称、类型和文本，演讲备注栏保持空值。
不要把所有形状拼接成讲稿，也不要自动修复文件。应请文稿作者判断自定义文本是否应移入备注正文。BODY 缺失本身不能证明文件损坏或库存在缺陷。上游问题 983 在要求提供示例文件但未获提供后关闭，本指南没有确定其故障原因。
让导出结果可核验，同时保留含义
明确设置 position、slide_id、state、notes 等列，并将缺失 BODY 的形状清单另存为 JSON。使用 csv.DictWriter、UTF-8 和 newline='' 写 CSV，再用 csv.DictReader 重读。核对记录数、页序、ID、状态及备注字符串全文。含换行的引号字段会跨物理行，因此应统计解析后的记录数。
默认 CSV 写入会把 None 序列化为空字段，区别必须由 state 列承载。测试中的四种状态均保留，含引号、换行和中文的备注往返一致。以 'x' 模式创建新输出，也确实拒绝覆盖已有目标。保留原 PPTX，不要为了导出文本调用 prs.save。
处理完异常清单，再验收讲稿
导出记录数应与幻灯片总数一致，每个位置只出现一次。让作者确认 no-notes-slide 与 no-body-placeholder 两类页面。body-empty 只表明现有正文文本框为空，不能独自证明作者有意留白。对不能容忍遗漏的流程，应在这些决定有记录后再进入下一步。
官方文档早已说明无创建检查与 BODY 缺失；现有完整脚本也能处理 None，或只导出非空备注。已审读的三状态 CSV 教程同样能安全记录缺失和空备注。本文新增的是可复现的第四种异常及验收对照。未测试 PowerPoint、Keynote、Google Slides 界面、旧 .ppt、加密或恶意包、富文本保真、母版继承文本，亦不承诺任意形状都能恢复。
