开会员与付费前请必须阅读这篇文章，在首页置顶第一篇：（进站必看本站VIP介绍/购买须知）
本站所有源码均为自动秒发货，默认（百度网盘）
本站所有源码均为自动秒发货，默认（百度网盘）
在 Python 编程中，我们经常需要对类的属性进行读取、修改或验证操作。直接暴露属性虽然简单，但会丧失对属性的管控能力；而通过 getter/setter 方法又会让代码显得冗余。
@property装饰器正是为解决这一矛盾而生 —— 它既能像访问普通属性一样操作，又能在背后执行自定义逻辑，是 Python 面向对象编程中不可或缺的优雅工具。一、@property 的核心作用
@property是 Python 内置的装饰器，本质上是一个描述符（descriptor），其核心作用是：- 将类的方法 “伪装” 成属性，调用时无需加括号，语法更简洁；
- 对属性的读取、赋值、删除操作进行精细化控制；
- 实现属性的动态计算、数据验证、权限控制等功能；
- 保持接口一致性，无需修改外部调用方式即可重构内部逻辑。
二、基础用法：将方法转为 “只读属性”
最基础的用法是将类方法装饰为只读属性，适用于需要动态计算的属性场景。
示例 1：计算圆的面积
python
运行
import math
class Circle:
def __init__(self, radius):
self.radius = radius # 基础属性
# 将area方法装饰为属性
@property
def area(self):
"""计算圆的面积（只读属性）"""
return math.pi * self.radius **2
# 调用示例
if __name__ == "__main__":
c = Circle(5)
print(f"圆的半径：{c.radius}")
# 像访问普通属性一样调用，无需加()
print(f"圆的面积：{c.area:.2f}") # 输出：78.54
# 尝试修改只读属性会报错
try:
c.area = 100
except AttributeError as e:
print(f"报错信息：{e}") # 输出：can't set attribute
关键点：
- 装饰后的
area不再是方法，而是属性，调用时直接写c.area而非c.area()； - 未定义 setter 时，该属性为只读，赋值会抛出
AttributeError。
三、进阶用法：读写属性（getter + setter）
如果需要对属性进行赋值操作，可配合
@属性名.setter装饰器定义 setter 方法，实现属性的写控制。示例 2：带验证的年龄属性
python
运行
class Person:
def __init__(self, name, age):
self.name = name
# 初始化时直接赋值给私有属性
self._age = age
# 定义getter：读取age属性时执行
@property
def age(self):
"""获取年龄（带格式处理）"""
return f"{self._age}岁"
# 定义setter：赋值age属性时执行
@age.setter
def age(self, value):
"""设置年龄（带数据验证）"""
if not isinstance(value, int):
raise TypeError("年龄必须是整数")
if value < 0 or value > 150:
raise ValueError("年龄必须在0-150之间")
self._age = value
# 调用示例
if __name__ == "__main__":
p = Person("张三", 25)
print(p.age) # 输出：25岁
# 合法赋值
p.age = 30
print(p.age) # 输出：30岁
# 非法赋值（触发验证）
try:
p.age = 200
except ValueError as e:
print(f"报错：{e}") # 输出：年龄必须在0-150之间
核心逻辑：
- 私有属性
_age：真正存储数据的载体（Python 中用下划线表示私有属性，约定俗成）； @property装饰的age：getter 方法，负责读取属性时的逻辑（如格式处理）；@age.setter装饰的age：setter 方法，负责赋值时的逻辑（如数据验证）；- 外部调用：
p.age读取、p.age = 30赋值，完全像操作普通属性。
四、高级用法：删除属性（deleter）
配合
@属性名.deleter装饰器，可定义属性删除时的逻辑，适用于需要清理资源的场景。示例 3：可删除的用户头像属性
python
运行
class User:
def __init__(self, username):
self.username = username
self._avatar = None # 头像路径
@property
def avatar(self):
"""获取头像路径"""
if self._avatar is None:
return "默认头像.png"
return self._avatar
@avatar.setter
def avatar(self, path):
"""设置头像路径（验证文件格式）"""
if not path.endswith((".png", ".jpg", ".jpeg")):
raise ValueError("仅支持png/jpg/jpeg格式")
self._avatar = path
@avatar.deleter
def avatar(self):
"""删除头像（重置为默认）"""
print(f"清理{self.username}的头像文件：{self._avatar}")
self._avatar = None
# 调用示例
if __name__ == "__main__":
u = User("pythoner")
print(u.avatar) # 输出：默认头像.png
u.avatar = "my_avatar.png"
print(u.avatar) # 输出：my_avatar.png
# 删除属性
del u.avatar
print(u.avatar) # 输出：默认头像.png
说明：
del u.avatar会触发@avatar.deleter装饰的方法；- 实际开发中，可在 deleter 中添加文件删除、数据库清理等逻辑。
五、@property 的应用场景
- 数据验证：如年龄、价格、长度等属性的合法性校验；
- 动态计算：如圆的面积、矩形的周长、商品折扣价等；
- 格式转换：如时间戳转字符串、数字转金额格式；
- 权限控制：如仅管理员可修改的属性；
- 懒加载：属性首次访问时才加载数据（如从数据库读取）。
六、常见误区
- 混淆方法与属性：装饰后的方法调用时无需加括号，加括号会报错；
- 忘记定义私有属性：直接在 getter/setter 中操作自身（如
self.age = value）会触发递归，必须用_age等私有属性存储数据； - 过度使用：简单属性无需封装，仅在需要管控时使用
@property； - 性能问题：若 getter 中包含复杂计算（如大数据处理），建议缓存结果，避免重复计算。
七、总结
@property是 Python 中实现 “优雅封装” 的核心工具，它的价值在于：- 兼顾简洁性（像访问普通属性）和可控性（自定义读写逻辑）；
- 无需修改外部调用方式，即可灵活扩展属性的逻辑；
- 遵循 “开闭原则”，在不破坏现有代码的前提下优化属性管理。
掌握
@property的用法，能让你的 Python 类设计更符合面向对象的封装思想，代码更优雅、更易维护。建议在实际开发中，针对需要管控的属性优先使用@property，而非直接暴露或手写大量 getter/setter 方法。
