Python子类怎么正确重写父类的@property属性

在 Python 面向对象编程中，子类直接使用 @property 重写父类同名属性时，常常会导致父类既有的 Setter 被全量遮蔽并抛出 AttributeError: can't set attribute，或者在 Setter 内部尝试使用 super().attr = val 时引发语法与运行时异常。正确重写的核心原则是：利用父类已有描述符派生出新属性对象（如 @Parent.attr.getter 或 @Parent.attr.setter），保留不需要改动的访问器；并在重写 Setter 时，通过 Parent.attr.fset(self, value) 直接调用底层赋值函数。

一、为什么直接重写会导致 Setter 丢失

在 Python 中，@property 并不是普通的实例属性，而是一个实现了描述符协议（Descriptor Protocol）的类属性对象。父类在类体中声明属性时，会将包含读取函数（fget）、写入函数（fset）和删除函数（fdel）的 property 对象存放在父类的 __dict__ 命名空间中。

当子类使用常规语法定义同名方法时：

class Parent:
    def __init__(self, value):
        self._value = value

    @property
    def value(self):
        return self._value

    @value.setter
    def value(self, val):
        self._value = val

class Child(Parent):
    # 错误重写：重新使用了 @property
    @property
    def value(self):
        return super().value * 2

此时 Python 会在 Child 的字典中创建一个全新的 property 对象。这个全新对象仅设置了 getter，其内部的 fset 为 None。当程序对子类实例执行 child.value = 100 时，解释器优先在子类字典中查找到该描述符，发现其并不支持写入，便会立刻抛出异常，而绝不会向上回退查找父类的 setter。

二、正确重写操作流程与实现语法

重写父类的 @property 属性时，需要根据实际需求判断改动范围，并选择对应的保留语法：

1. 仅重写 Getter，保留父类 Setter

如果子类只需要对读取逻辑做后处理（例如转换数据格式、追加前缀或数值缩放），可以使用 @Parent.属性名.getter 装饰器：

class Parent:
    def __init__(self, value):
        self._value = value

    @property
    def value(self):
        return self._value

    @value.setter
    def value(self, val):
        self._value = val

class Child(Parent):
    # 正确做法：基于父类的描述符派生，自动保留原有的 setter
    @Parent.value.getter
    def value(self):
        # 通过 super().value 访问父类的 getter 读取逻辑
        raw_val = super().value
        return f"Child-Format: {raw_val}"

验证执行：

c = Child("test")
print(c.value)      # 示例输出: Child-Format: test
c.value = "updated" # 正常执行父类 setter，未报错
print(c.value)      # 示例输出: Child-Format: updated

2. 仅重写 Setter，保留父类 Getter

如果需要对写入逻辑做参数验证、权限检查或触发额外副作用，同时保留父类原本的 Getter 逻辑，可以使用 @Parent.属性名.setter：

class Child(Parent):
    # 正确做法：基于父类的描述符注册新的 setter，原 getter 得以保留
    @Parent.value.setter
    def value(self, val):
        if not isinstance(val, str):
            raise TypeError("value 必须是字符串类型")
        if len(val) == 0:
            raise ValueError("value 不能为空")
        # 关键避坑：必须显式调用父类 property 的 fset 函数
        Parent.value.fset(self, val)

三、全量显式重写与不同方案对比

若子类的业务逻辑发生较大变化，Getter 和 Setter 都需要全面替换，则可以在子类中完整重新声明属性体系：

class Child(Parent):
    @property
    def value(self):
        # 自定义 getter
        return super().value.strip().lower()

    @value.setter
    def value(self, val):
        # 自定义 setter
        if not isinstance(val, str):
            raise TypeError("必须传入字符串")
        Parent.value.fset(self, val.strip())

为了在实际开发中做出合理选型，可参照下表对不同实现方式的关键差异进行评估：

四、更优的工程实践：模板方法解耦重构

如果父类的代码维护权在当前项目内，最优雅且符合 Pythonic 风格的做法是将属性访问逻辑与属性装饰器分离。即在父类中通过模板方法模式（Template Method Pattern）将底层计算委托给内部函数：

class Parent:
    def __init__(self, value):
        self._value = value

    @property
    def value(self):
        return self._get_value()

    @value.setter
    def value(self, val):
        self._set_value(val)

    # 供子类重写的钩子函数
    def _get_value(self):
        return self._value

    def _set_value(self, val):
        self._value = val

采用此设计后，子类无需再与复杂的 property 描述符语法周旋，直接按常规面向对象方式重写普通方法即可：

class Child(Parent):
    def _get_value(self):
        # 自由使用标准 super()
        return super()._get_value() * 2

    def _set_value(self, val):
        # 标准方法重写，无需关心 fset
        super()._set_value(val.strip())

这种架构彻底规避了子类重写属性时的描述符遮蔽与属性绑定陷阱，是大型面向对象工程中的推荐实践。

五、核心避坑清单与知识总结

在实际编写与维护相关代码时，请重点关注以下三项规则：

1. 切勿在子类中使用非装饰语法直接覆盖：如果直接写 @property def attr(self):，必须意识到父类的 Setter 会完全失效。
2. 牢记 super() 的单向性：读取时 super().attr 能够正常触发父类 Getter；但写入时 super().attr = value 绝对不可行，必须改用 Parent.attr.fset(self, value)。
3. 注意多继承（MRO）中的显式绑定：使用 @Parent.attr.setter 时显式硬编码了 Parent 类名，在菱形继承等多继承拓扑中可能无法按照 MRO 动态解析，若有复杂继承需求应优先采用第四节的内部方法解耦方案。