Python教程：@property装饰器

Python中的@property装饰器

是一种非常有用的工具，它允许你将类的方法当作属性来访问。这意味着你可以像访问数据属性一样访问一个方法，但实际上这个方法会在你尝试获取或设置属性值时被调用。这样做的好处是，你可以在不改变类外部代码的情况下，控制对类属性的访问和修改，包括执行额外的逻辑，如验证、计算值等。

基本用法

使用@property装饰器非常简单。首先，你定义一个使用@property装饰的getter方法，该方法不接受除了self之外的任何参数，并返回你想要作为属性访问的值。然后，你可以可选地定义setter和deleter方法，分别用于设置和删除属性值，这些方法分别使用@<属性名>.setter和@<属性名>.deleter装饰器。

示例

class Circle:  
    def __init__(self, radius=1.0):  
        self._radius = radius  
  
    @property  
    def radius(self):  
        """获取圆的半径"""  
        return self._radius  
  
    @radius.setter  
    def radius(self, value):  
        """设置圆的半径，确保半径为正数"""  
        if value >= 0:  
            self._radius = value  
        else:  
            raise ValueError("Radius must be non-negative")  
  
    @radius.deleter  
    def radius(self):  
        """删除圆的半径（这里只是设置为默认值）"""  
        raise AttributeError("Can't delete attribute")  
  
# 使用  
c = Circle(5)  
print(c.radius)  # 调用getter，输出: 5  
c.radius = 10    # 调用setter  
print(c.radius)  # 再次调用getter，输出: 10  
  
# 尝试设置非法值  
try:  
    c.radius = -1  
except ValueError as e:  
    print(e)  # 输出: Radius must be non-negative  
  
# 尝试删除属性  
try:  
    del c.radius  
except AttributeError as e:  
    print(e)  # 输出: Can't delete attribute

注意事项

使用@property装饰器时，你通常会将实际的属性名（如_radius）前加上单下划线（_），以表示这是一个受保护的属性，不应该直接从类的外部访问。

@property装饰器实际上是将你的getter方法转换为一个同名的特殊属性。因此，当你尝试访问这个属性时，Python会自动调用相应的getter方法。

如果你没有定义setter或deleter方法，那么尝试设置或删除该属性将会引发AttributeError。
在一些情况下，你可能想要同时提供原始属性和通过@property装饰的属性。这通常不是最佳实践，因为它可能会使类的行为变得难以预测。然而，如果你确实需要这样做，你可以考虑使用不同的属性名或使用其他技术（如私有属性和公共getter/setter方法）。