python中怎么使用@property装饰器？-Python教程-PHP中文网

python中怎么使用@property装饰器？

冰火之心

发布： 2025-09-13 14:28:01

原创

873人浏览过

@property装饰器将方法转为属性访问，实现简洁接口与内部控制的平衡，支持读、写、删的精细化管理，如数据校验和动态计算。

python中怎么使用@property装饰器？

Python中的

@property

登录后复制

装饰器，简而言之，就是一种优雅地将类方法转化为属性访问方式的工具。它允许你像访问普通属性一样去调用一个方法，同时在背后可以执行复杂的逻辑，比如数据校验、权限控制，甚至是动态计算。它让你的代码在保持接口简洁的同时，拥有更强大的控制力，是实现数据封装和抽象的一种Pythonic方式。

要使用

@property

登录后复制

，最基础的场景是创建一个“只读”属性。你只需在一个方法上方加上它，这个方法就会变成一个可以被直接访问的属性。

class Circle:
    def __init__(self, radius):
        # 通常用单下划线前缀表示这是一个“受保护”或内部使用的属性
        self._radius = radius 

    @property
    def radius(self):
        """返回圆的半径，这是一个只读属性。"""
        print("正在获取半径...")
        return self._radius

    @property
    def diameter(self):
        """计算并返回直径，这也是一个只读属性。"""
        print("正在计算直径...")
        return self._radius * 2

# 使用示例
c = Circle(5)
print(f"圆的半径是: {c.radius}") # 看起来像访问属性，但实际上调用了radius方法
print(f"圆的直径是: {c.diameter}")
# 尝试设置c.radius = 10 会报错：AttributeError: can't set attribute

登录后复制

但

@property

登录后复制

的真正威力在于它能让你对属性的“读”、“写”、“删除”操作进行精细化控制。它通过

@<property_name>.setter

登录后复制

和

@<property_name>.deleter

登录后复制

来扩展功能，为你提供完整的属性生命周期管理。

class Person:
    def __init__(self, name):
        self._name = name
        self._age = 0

    @property
    def name(self):
        """获取姓名"""
        print("正在获取姓名...")
        return self._name

    @name.setter
    def name(self, value):
        """设置姓名，并进行简单的校验"""
        print(f"正在尝试设置姓名为: {value}")
        if not isinstance(value, str) or not value.strip():
            raise ValueError("姓名必须是非空的字符串！")
        self._name = value.strip()

    @name.deleter
    def name(self):
        """删除姓名（通常不常用，但展示功能）"""
        print("正在删除姓名...")
        del self._name
        # 实际项目中可能更倾向于设置为None或抛出错误，而不是直接删除底层属性

    @property
    def age(self):
        """获取年龄"""
        return self._age

    @age.setter
    def age(self, value):
        """设置年龄，确保是合理的数值"""
        if not isinstance(value, (int, float)) or not (0 <= value < 150):
            raise ValueError("年龄必须是0到150之间的数字！")
        self._age = int(value) # 强制转换为整数

# 使用示例
p = Person("Alice")
print(f"初始姓名: {p.name}")

p.name = "Bob" # 调用name属性的setter方法
print(f"新姓名: {p.name}")

try:
    p.name = 123 # 触发ValueError，因为setter中进行了类型校验
except ValueError as e:
    print(f"设置姓名失败: {e}")

try:
    p.age = -5 # 触发ValueError，因为setter中进行了范围校验
except ValueError as e:
    print(f"设置年龄失败: {e}")

p.age = 30
print(f"年龄: {p.age}")

# del p.name # 调用name属性的deleter方法，会删除_name属性
# print(p.name) # 再次访问会报错AttributeError

登录后复制

从本质上讲，