使用场景#

数据字典至少要写字段名、中文含义、类型、单位、缺失含义、枚举值和来源系统。写完以后，再开始做清洗和统计。

我会先准备一个小样本，保证可以人工检查结果。大表直接跑起来很快，但一旦结果不对，很难判断是代码错、字段错，还是数据本身脏。

最小代码#

1
field: amount
2
name: 实付金额
3
type: decimal
4
unit: yuan
5
missing: unknown
6
source: order_system.payment_amount

检查结果#

• 行数是否符合预期，不能只看代码是否报错。
• 关键字段的类型、缺失值和唯一值数量是否合理。
• 输出结果能否用三到五行样本手工复算。
• 如果生成报表，要保留清洗前后的对账数字。

容易忽略的点#

容易忽略的是单位和时间口径。金额是元还是分，日期是下单时间还是支付时间，都会改变结果解释。

最小验收样例#

我会用三行数据做一次手工验收：一行正常记录，一行边界记录，一行异常记录。代码跑完后，把输出和手工计算结果对照一遍，确认不是字段名写对了但口径理解错了。

如果这一步会进入日报、周报或正式报告，还要把输入行数、输出行数和被过滤的记录数写到日志里。数据处理的可信度，来自这些可以复查的中间证据。

小结#

数据字典先于分析代码 要解决的是一个可复查的数据处理问题。先定义口径，再写代码，最后用样本和统计结果验收，分析结果才站得住。