PPT一页没删，放映却少一页：用单变量样本检查隐藏属性

做演示文稿审阅时，很容易先关注文字、图片和排版：标题改了吗，表格数字变了吗，页面有没有增删。但有一种变化可以绕过这些检查——文件里仍有同一页，文本、形状和顺序都没变，这一页却被设置为不参与普通放映。

这次我用一张完全合成的文本幻灯片，把“显示或隐藏”单独拿出来验证。实验在本机完成，不使用业务课件，不启动云资源，也不把文件结构检查冒充成已经在PowerPoint中自动播放验收。

先把两个问题分开

“文件中有没有这一页”和“放映时是否显示这一页”是不同的属性。隐藏页仍可以保留在文档中，供后续编辑或特定场合使用。于是，只比较页数、文本和对象数量，不能覆盖放映可见性。

在PPTX的Open XML结构中，一张幻灯片有自己的XML部件。本次单页样本对应 ppt/slides/slide1.xml。Microsoft Learn的Open XML SDK文档把 Slide.Show 描述为幻灯片是否出现在放映中，对应属性名 show。我检查的就是这个页级属性，没有改背景、文本或任何形状。

这里还有一个容易踩的Python细节：bool("false") 的结果是 True，因为非空字符串本身是真值。XML布尔值应该显式处理，不能直接交给Python的字符串真值规则。下面的示例区分 0/false 和 1/true；对本实验生成的缺省样本按正常显示处理，遇到其他字符串就报错，避免悄悄吞掉异常值。

为什么不直接另存两份PPT再比较

如果先打开应用，再分别保存两个版本，文件时间、包内元数据或其他XML也可能一起变化。这样即使检测到了差异，也不容易证明它只来自隐藏状态。

我的做法是先生成一份单页文件，再复制它的所有ZIP条目，只在指定XML根元素上增加一个 show 属性。生成后再逐项比较解压后的部件内容，要求变化列表严格只有 ppt/slides/slide1.xml。这一步是实验控制，不是声称整个ZIP二进制只改了几个字节：压缩流和包的整体哈希可以不同。

三组输入分别是显式显示 1、隐藏 0、隐藏 false。显示组是阴性对照：属性的写法发生了变化，可见性语义没有变。两组隐藏写法则用于检查数值与单词形式是否被一致处理。

可运行的单变量实验

代码需要 python-pptx，本次使用已有的1.0.2版本。所有样本都写入新建的临时目录，结束后自动清理；不会编辑现有课件。ZipFile(..., "x") 保证不会覆盖同名输出，同一路径也会在写入之前被拒绝。

from pathlib import Path
from tempfile import TemporaryDirectory
from zipfile import ZipFile
import xml.etree.ElementTree as ET

from pptx import Presentation
from pptx.util import Inches

PART = "ppt/slides/slide1.xml"


def normalize_show(raw):
    if raw is None or raw in ("1", "true"):
        return True
    if raw in ("0", "false"):
        return False
    raise ValueError(f"Unsupported show value: {raw!r}")


def read_show(path):
    with ZipFile(path) as archive:
        raw = ET.fromstring(archive.read(PART)).get("show")
    return raw, normalize_show(raw)


def copy_with_show(source, target, value):
    source, target = Path(source), Path(target)
    if source.resolve() == target.resolve():
        raise ValueError("Source and target must differ")
    if value not in ("0", "1", "false", "true"):
        raise ValueError("Invalid XML boolean")
    with ZipFile(source) as src, ZipFile(target, "x") as dst:
        for info in src.infolist():
            data = src.read(info.filename)
            if info.filename == PART:
                assert b" show=" not in data
                assert data.count(b"<p:sld ") == 1
                data = data.replace(
                    b"<p:sld ", f'<p:sld show="{value}" '.encode(), 1
                )
            dst.writestr(info, data)


def changed_parts(left, right):
    with ZipFile(left) as a, ZipFile(right) as b:
        assert set(a.namelist()) == set(b.namelist())
        return [name for name in a.namelist() if a.read(name) != b.read(name)]


def make_visible(path):
    prs = Presentation()
    slide = prs.slides.add_slide(prs.slide_layouts[6])
    slide.shapes.add_textbox(
        Inches(1), Inches(1), Inches(5), Inches(1)
    ).text = "Quarterly review demo"
    prs.save(path)


def demo():
    with TemporaryDirectory() as folder:
        visible = Path(folder) / "visible.pptx"
        make_visible(visible)
        for name, value in (("explicit", "1"), ("hidden", "0"), ("hidden_word", "false")):
            target = Path(folder) / f"{name}.pptx"
            copy_with_show(visible, target, value)
            raw, shown = read_show(target)
            print(name, repr(raw), shown, changed_parts(visible, target))


if __name__ == "__main__":
    demo()

本机实际输出如下。每一组都只有一个部件发生变化；隐藏组的规范化结果都是 False，显式显示组是 True。

explicit '1' True ['ppt/slides/slide1.xml']
hidden '0' False ['ppt/slides/slide1.xml']
hidden_word 'false' False ['ppt/slides/slide1.xml']

这份代码刻意只面向自己生成的单页样本。它固定读取slide1部件，不能直接当作多页课件的放映顺序枚举器；真实文档中的页面顺序需要沿演示文稿的关系和页列表读取，而不能简单按ZIP文件名排序。改变范围小，结论才容易核查。

接到现有比较工具后，控制组很重要

我另外把这些样本交给PPT-diff当前公开main分支的原始解析器和比较器，核对修订为 da3694eacb3bd0dfbcc175d07d7c2659ffc84d1c，没有修改项目源代码。

结果是：可见文件与隐藏文件解析出的字典完全相同。直接比较一页得到 unchanged；经公开比较入口汇总得到 modified=0、moved=1。如果只看到这一行，很容易把“隐藏页被当作移动”当成全部问题。

但同文件与自身比较也得到相同汇总。因此我把两件事分开：未变页被记成moved是已有的独立现象，不能借这个结果再报一次；本次新增验证的是隐藏属性没有进入解析模型，导致可见版本与隐藏版本在比较层不可区分。阴性对照帮助我避免把旧问题包装成新发现。

沿数据链检查，遗漏发生在页级内容模型和解析阶段：没有保留放映可见性，后面的比较器自然无从比较。只给HTML模板加一个“隐藏”标签并不能补回已经丢失的信息。合理的处理顺序是先解析原值、规范化布尔值，再比较新旧状态，最后让报告表达变化。

我实际检查了什么

示例的9项独立测试覆盖了：属性缺省、数值真、单词真、数值假、单词假、非法值拒绝、仅指定XML变化且源文件不变、同路径写入拒绝、已有输出文件保留。三组真实PPTX对照也已经运行，文章代码的输出与上面的记录一致。

如果后续把这一能力加入比较工具，我会再验收四种关系：正常显示到隐藏、隐藏到正常显示、缺省到显式显示、同文件自比较。前两种应该提示状态变化，后两种不应该凭空增加可见性差异。原有文字、样式、图片和备注比较也需要继续通过各自的回归测试。

本次没有运行PowerPoint放映、没有验证应用内缩略图或自定义放映列表，也没有宣称开源项目已经修复。这里证明的是文件属性变化、解析信息丢失和对照结果之间的关系。把这些边界写清楚，下一位开发者才知道能直接复现什么，还需要补哪一层验收。

这类检查不只适用于PPT。只要一个对象同时有“内容”和“是否参与某个流程”的状态，审阅工具就需要先定义观察面：内容相同，不意味着执行行为一定相同。用可控样本、明确对照和真实输出逐层验证，比仅凭最终报告上的一个状态词推断原因更可靠。

参考：Microsoft Learn《Slide.Show Property（Open XML SDK）》；Python标准库zipfile文档；python-pptx项目文档；PPT-diff公开main分支上述修订。实验样本均为合成数据，结论限于本文说明的代码与文件结构检查。