表目录

表目录：从表格数值即结论推进到口径一致后再做定量判断，核对表号、定义、单位、样本和版本。

学习目标

能从表目录定位表号、变量定义、单位、样本、版本与比较口径。
能判断两个数值是否真的可比，并在分母、年份或项目规模不同的时候拒绝结论。
能用正常、边界、故障和复位四条轨迹重建一项定量判断，保留计算和证据。

为什么需要这一机制

表目录不是数字的索引，而是比较合同的入口。一个表格中的百分比、平均值或趋势只有在变量定义、单位、分母、样本、时间和版本一致时才支持比较。先找到表号，再核对口径，最后才允许把差异写成工程判断。

先避开三个表格误区

核心合同与操作术语

可比性要求：变量定义相同、单位相同、分母相同、样本和观察窗口可解释。是入口，不是结论；决定数字表示的对象。

决定能否比较；防止把不同条件拼在一起；才是最终产物。

目录节点逐项深读

表目录的工程任务是把表格定位接到可复查比较。先记录表号和来源，再复制变量定义、单位、分母、样本、年份和版本；只有这些条件一致，才允许计算差异或趋势。若条件不一致，正确产物是拒绝理由和补数计划，而不是一个看似精确的百分比。

最小可重放实现

left = read_table(table_id, definition, unit, sample, version)
right = read_table(other_id, definition, unit, sample, version)
assert comparable(left, right)
result = compare(left, right)
record(result, inputs, formula, boundary)
reset()
assert replay(inputs) == result

正常轨迹确认两个表可比；边界轨迹改变分母或观察窗口；故障轨迹注入不同年份或项目规模；复位轨迹恢复原始输入并重新计算。不能比较时，拒绝本身就是有效的工程结论。

先预测，再操作证据实验

先预测表号、口径或样本改变后哪一个节点会先变化，再只切换一个场景。组件中的数值链是教学模型，不代表任何真实项目的统计结果。

表目录 · 证据实验

表号 → 变量定义 → 单位与样本 → 版本口径 → 定量判断

固定版本、输入和观察窗口，只改变一个条件；先预测首个偏离，再用同一基线复位。

练习与答案

练习

问题 1：判断可比性。 两张表都报告“缺陷率”，但一张用每千行代码，另一张用每个功能点。你会怎么处理？

问题 2：补齐表格证据。 一位同事只给出“表 4-1 显示新版本更快”。请列出至少四个需要追问的字段。

问题 3：设计复位。 重新计算后发现结果变好，但输入版本也被改了。如何诊断？

术语表

名词解释

本章出现的专业名词，用大白话再讲一遍。

表号: 定位表格及其标题、来源和上下文的标识。
变量定义: 说明行列对象、采集方式和计算含义的约束。
单位与样本: 数值单位、分母、样本和观察窗口的组合。
版本口径: 数据产生时的软件、年份、配置和筛选条件。
定量判断: 在口径一致、计算可复查且边界明确后形成的决定。

本页小结

表目录的正确顺序是定位表号、核对定义、统一单位与样本、固定版本口径，最后才做定量判断。数据无法比较时，清楚记录拒绝理由比制造一个精确数字更可靠。