@property 装饰器的作用和用法

---

前言

在复现别人的代码时看到了在定义方法前一行有一个@property，对此感到很疑惑，于是上网查阅了它的用途。

---

一、@property介绍

1、@property 装饰器在 Python 中用于将一个方法转换为属性，提供了一种简洁和可读性更高的方式来访问类的属性。
2、使用 @property 装饰器可以将一个方法定义为类的属性，并且在访问该属性时无需使用括号调用方法，而是像访问普通的实例属性一样直接访问。这样可以使代码更加简洁并提供更友好的接口。

二、@property 装饰器的用途

（1）封装属性访问：@property 可以将一些敏感或计算复杂的属性封装在一个方法中，通过方法的调用来获取属性值，隐藏了属性的具体实现细节。
（2）属性验证：在属性的 getter 方法中，可以添加额外的验证逻辑来确保属性值的有效性，防止非法或不符合要求的值被设置。
（3）动态属性：可以根据其他属性的状态来动态计算属性的值，这样每次访问属性时都会得到最新的计算结果。
总之，@property 装饰器提供了一种方便和优雅的方式来定义和使用类的属性，使代码更加易读和可维护。

三、代码示例

当我们定义一个属性时，可以使用 @property 装饰器将其转换为可访问的属性。下面是一个示例：

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

    @property
    def area(self):
        return 3.14 * self.radius ** 2

    @property
    def perimeter(self):
        return 2 * 3.14 * self.radius

circle = Circle(5)
print(circle.radius)    # 输出: 5
print(circle.area)      # 输出: 78.5
print(circle.perimeter) # 输出: 31.4

在上面的例子中，我们定义了一个 Circle 类，其中 radius 是一个普通的实例属性，而 area 和 perimeter 则是被 @property 装饰器修饰的方法。

通过将这两个方法转换为属性，我们可以像访问实例属性一样直接访问 circle.area 和 circle.perimeter，而无需使用括号调用方法。

注意：这两个属性是只读的，也就是说不能通过赋值来修改它们的值。如果需要修改属性的行为，可以添加相应的 setter 方法，并使用 @属性名.setter 装饰器来定义。

---

提示：本文只是关于装饰器的简单例子