excel表格质检

交付 Excel 前查公式错误、隐藏行列与外部引用

表格发出去前·公式和隐藏内容

这个 Skill 解决什么

表格最危险的地方是它不报错。

SUM 少算了几行，因为有几个数字是"文本格式的数字"；筛选之后总数对不上，因为有几行被隐藏了；发给对方后一片 #REF!，因为公式引用了本地另一个文件。这些在你自己的屏幕上全都是正常的。

这个 Skill 专门查这类"静默错误"。

工作流程

第 1 步：确认这份表是干什么用的

只问会改变结论的事：

• 对方拿到后要做什么：只是看 / 要接着算 / 要导入系统 / 要透视分析
• 数字从哪来：手工录入 / 导出 / 别的系统对接

如果对方要接着算或导入系统，那么"文本型数字""合并单元格""隐藏行列"的严重度要整体上调——这三样在下游全是事故源。如果对方只是看，它们就不算什么。

用户没说就按"对方要接着用"处理，并在结论里写明假设。

第 2 步：跑脚本

bash

python scripts/qc_xlsx.py <文件.xlsx>

零第三方依赖，直接读 OOXML。检查：

代码	含义	为什么危险
FORMULA_ERROR	公式错误值	对方第一眼就看到 #REF!
EXTERNAL_REF	引用外部工作簿	对方打开必然取不到值
TEXT_NUMBER	数字存成文本	SUM / 排序 / 透视表静默漏算
HIDDEN_COL HIDDEN_ROW	隐藏的行列	复制、统计、对账时漏数据
HIDDEN_SHEET	隐藏的工作表	数据在无人察觉时被带走
MERGED_CELLS	合并单元格	排序、筛选、填充异常
PARSE_ERROR	文件结构异常	被第三方工具改写或传输损坏

第 3 步：把"数字对不上"翻译成"哪一步漏了"

用户最容易感知的痛点是"数怎么不对"。不要只报单元格位置，要说出它在业务上意味着什么。

差：B17 是文本型数字 好：B17、B23、B41 是文本存储的数字（合计 8,640）。现在 B50 的 SUM 把它们漏掉了，你看到的合计比真实值少 8,640。

第 4 步：口径问题要问，不要猜

脚本查不出"口径对不对"。当发现以下迹象时，提问而不是断言：

• 同一份表里有多个相似名称的列（"金额"/"含税金额"/"实收"）
• 出现占比、同比、人均这类派生指标，但看不到分母在哪
• 有隐藏行列且它们看起来像同源数据

问法："这张表里 B 列是『金额』、D 列是『实收』，两者差在税费还是退款？我要确认合计该用哪一列。"

边界

• 能做的：结构层面的确定事实、公式与类型问题、隐藏内容、合并单元格。
• 不能做的：判断业务口径是否正确、判断数字是否符合现实（这些需要业务知识）。
• 必须说明的：脚本不重算公式。它读的是文件里缓存的数值。如果文件从未被 Excel 完整打开过，缓存值可能为空或过期。

触发场景

凡出现以下任一任务时主动调用，不必等对方点名：

• 要把一份 xlsx 发给老板或客户之前
• 要确认公式错误、漏算的文本数字、隐藏行列与隐藏工作表

口语化说法同样命中：帮我检查这个表格 / 公式有没有算错 / 数据能不能直接发给老板 / 表里有没有藏东西

输出模板

text

结论：可交付 / 修完再发

【会直接报错】
1. B17 显示 #REF!。原因：公式引用了已删除的单元格。改法：重新指向正确区域。

【会让数字静默出错】
2. B17、B23、B41 是文本格式的数字（合计 8,640），当前 SUM 漏算。改法：选中该列，数据-分列-直接完成。

【对方看不到但确实存在】
3. 「内部备份」工作表被隐藏，里面有 2 行数据。如果这是故意保留，建议改为单独文件。

【需要你确认】
- 合计该用 B 列（金额）还是 D 列（实收）？

说明：以上为结构检查结果，未重算公式，读的是文件缓存值。