dataclass 字段默认值写成列表报 ValueError·default_factory 怎么用

from dataclasses import dataclass, field

@dataclass
class Job:
    items: list = field(default_factory=list)

dataclass 字段写成 items: list = []，定义类时抛 ValueError: mutable default。这类现象通常不是突然出现的，往前翻半天日志能看到苗头。

追下去是这么回事：类属性只求值一次，所有实例会共用同一个列表，改一个影响全部，dataclass 在定义阶段就把这种写法拦住。

围绕「dataclass 可变默认值」排查时，命令行跑一遍比在面板里点十次有用，面板会替你做掉不少隐式操作。权限不要一口气开到最大，先加到够用再往上试，范围小才好收。

把复现步骤压到三条以内，交给同事也能跑出来，才算真的定位清楚。改动写完就同步给同事，下一个人踩同一个坑，成本还是你的。

验证用真实数据走一遍，测试数据太干净，边界情况根本碰不到。

处理上按这个顺序：改用 field 的 default_factory 生成新列表；字典和集合同样处理，别在字段上直接写空字面量；本该各实例各自独立的状态，不要放在类属性上。

确认没问题再收工，两个实例各改各的列表互不影响，类定义阶段也不再报错。