Python 中的 property

什么是 property？

在 Python 中，property 是一个内置函数，用于将类的方法转换为“只读”或“可控读写”的属性。 它允许你定义属性的 getter、setter 和 deleter 方法， 而无需改变调用方式（即仍可通过 obj.attr 访问）。

使用 @property 装饰器是实现这一功能的最常见方式。

基本用法示例

class Circle:
    def __init__(self, radius):
        self._radius = radius

    @property
    def radius(self):
        return self._radius

    @radius.setter
    def radius(self, value):
        if value < 0:
            raise ValueError("半径不能为负数")
        self._radius = value

    @property
    def area(self):
        return 3.14159 * self._radius ** 2

# 使用
c = Circle(5)
print(c.radius)   # 5
print(c.area)     # 78.53975
c.radius = 10     # 触发 setter
print(c.area)     # 314.159

为什么使用 property？

• ✅ 封装性：隐藏内部数据（如 _radius），防止直接修改。
• ✅ 数据验证：在设置属性时自动校验（如禁止负数）。
• ✅ 向后兼容：未来若需添加逻辑，无需修改调用代码。
• ✅ 只读属性：仅定义 getter 即可创建只读属性（如 area）。

三种定义方式

1. 装饰器方式（推荐）：使用 @property、@attr.setter 等。
2. 函数式方式：

   class Person:
       def __init__(self, name):
           self._name = name
   
       def get_name(self):
           return self._name
   
       def set_name(self, value):
           self._name = value.upper()
   
       name = property(get_name, set_name)

3. 混合方式：部分用装饰器，部分用函数式（不推荐，易混乱）。

注意事项

• 属性名不要和私有变量名冲突（通常用下划线前缀，如 _x）。
• 避免在 getter/setter 中执行耗时操作，以免误导使用者（看起来像普通属性）。
• 删除属性需定义 @attr.deleter 并使用 del obj.attr。