当前位置：首页 > news >正文

【python】内置装饰器-@property

news 2025/7/14 22:40:37

@property 是 Python 中的一个内置装饰器，用于将类的方法转换为属性访问方式。这种机制允许通过类的实例以类似访问属性的方式调用方法，从而实现更优雅和封装的代码结构。

主要功能

封装属性访问：使用 @property 可以将对属性的访问控制在方法中，从而实现对属性的读取和设置时进行额外的逻辑处理，如验证、计算等。
实现只读属性：通过仅定义 getter 方法，可以创建只读属性，防止外部修改属性值。
保持接口一致性：即使内部实现发生变化，对外接口保持不变，减少对使用该类的代码的影响。

基本用法

以下是一个简单的示例，展示如何使用 @property 装饰器：

class Rectangle:def __init__(self, width, height):self._width = widthself._height = height@propertydef width(self):"""获取宽度"""return self._width@width.setterdef width(self, value):"""设置宽度，并进行验证"""if value <= 0:raise ValueError("宽度必须大于0")self._width = value@propertydef height(self):"""获取高度"""return self._height@height.setterdef height(self, value):"""设置高度，并进行验证"""if value <= 0:raise ValueError("高度必须大于0")self._height = value@propertydef area(self):"""计算矩形面积"""return self._width * self._height# 使用示例
rect = Rectangle(3, 4)
print(rect.width)   # 输出: 3
print(rect.height)  # 输出: 4
print(rect.area)    # 输出: 12rect.width = 5
print(rect.area)    # 输出: 20# 尝试设置非法值会引发异常
# rect.height = -2  # 会引发 ValueError: 高度必须大于0

解释

私有属性：在类中，通常使用下划线（如 _width 和 _height）来表示私有属性，避免外部直接访问和修改。
@property 装饰器：将 width 和 height 方法转换为属性，使得可以通过 rect.width 和 rect.height 访问，而无需显式调用方法。
@setter 装饰器：配合 @property 使用，允许对属性进行赋值时执行额外的逻辑，如输入验证。
只读属性：area 属性仅定义了 getter 方法，没有 setter 方法，因此 rect.area 是一个只读属性，不能被修改。