@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从本质上讲，
@property是Python描述符协议的一种便捷实现。当你访问
obj.attribute时，Python会检查
attribute是否是描述符（
@property就是），如果是，就会调用其内部的
__get__、
__set__或
__delete__方法。这使得我们在不改变外部调用方式的前提下，对属性的存取逻辑有了完全的控制权。
立即学习“Python免费学习笔记（深入）”；
为什么我们需要@property装饰器？它的核心价值在哪里？
我个人觉得，
@property装饰器的核心价值，在于它在“简洁的接口”和“强大的内部控制”之间找到了一个完美的平衡点。设想一下，如果你想对一个类的属性进行一些额外的操作，比如在设置年龄时检查它是否合理，或者在获取文件名时自动加上扩展名。传统的做法可能是写一个
get_age()和
set_age()方法，就像Java里那样。这当然没问题，但代码会变得冗长，而且使用者需要明确知道这是一个方法调用。
@property的出现，让我们能以访问普通属性的语法（
obj.age）来触发这些复杂的逻辑。这对于API设计者来说简直是福音：
-
封装与数据校验： 这是最常见的用途。我们不再需要直接暴露内部的
_age
变量，而是通过
