如何在 attrs 子类中复用父类字段验证器并设置默认值

让子类继承父类验证器并安全覆盖默认值：attrs库的优雅解法

在Python的attrs库中处理类继承时，一个典型的挑战是：如何让子类既继承父类字段的验证逻辑，又能安全地指定自己的默认值？比如，一个Vehicle父类定义了带验证的num_wheels字段，而Car子类希望默认轮子数是4，同时确保任何赋值仍通过原有的类型和正整体验证。

直接重定义同名字段是行不通的。因为attrs的字段是类级别的声明对象，子类中重新定义num_wheels: int = 4会完全覆盖父类的字段定义，导致宝贵的验证器丢失。这背后的根本原因在于，字段定义本身并不具备继承性。

✅ 正确解法：复用父类字段定义，仅覆盖默认值

关键在于使用attrs.field(default=...)来显式复写字段，并显式引用父类字段的验证器。这样既能注入新默认值，又能牢牢锁住原有的验证逻辑。

from attrs import define, field, validators

@define(kw_only=True)
class Vehicle:
    num_wheels: int = field(
        validator=[validators.instance_of(int), lambda s, a, v: _validate_positive(v)]
    )

def _validate_positive(value):
    if value <= 0:
        raise ValueError("Number of wheels must be greater than 0")

@define
class Car(Vehicle):
    # 核心技巧：复用父类验证器，仅覆盖默认值
    num_wheels: int = field(default=4, validator=Vehicle.num_wheels.validator)

@define
class Motorbike(Vehicle):
    num_wheels: int = field(default=2, validator=Vehicle.num_wheels.validator)

⚠️ 需要留意的几个细节

• 验证器是列表：Vehicle.num_wheels.validator是一个列表（即使当初只传了一个验证器，attrs内部也会将其封装成列表），因此需要原样传递。
• 避免重复装饰：切忌在子类中使用@num_wheels.validator装饰器重新定义验证器，这会创建一个全新的字段，破坏继承链。
• 转换器也需复用：如果父类字段使用了converter，同样需要通过converter=Vehicle.num_wheels.converter显式继承。
• 关键字参数约束：若父类使用了kw_only=True，子类实例化时必须使用关键字参数（例如Car(num_wheels=4)），这是符合设计预期的行为。

? 进阶场景与替代思路

如果某个字段的值对于所有子类实例是固定常量（例如所有Car的轮子数永远是4），那么更语义化的做法或许是将其定义为类变量（ClassVar），并在__init__或__attrs_post_init__中注入。或者，可以考虑使用@define(slots=False)配合自定义的__init__方法。

然而，对于大多数需要保持attrs简洁性和性能优势的场景，上述field(default=..., validator=...)的方案最为轻量，也最符合库的原生范式，能够完整地保持验证链条。

最终效果验证

print(Car())           # Car(num_wheels=4) —— 默认值生效 ✅
print(Car(num_wheels=4))  # Car(num_wheels=4) ✅
Car(num_wheels=-1)    # ValueError: Number of wheels must be greater than 0 ✅
Car(num_wheels=3.14)  # TypeError: ... instance_of(int) failed ✅

可以看到，验证器被无缝继承，默认值被精准覆盖，整个过程无需侵入式代码修改。这无疑是生产环境中所推荐的稳健实践。