欢迎来到 Python 学习计划的第 46 天！🎉
昨天我们学习了 运算符重载，让对象支持数学运算。今天，我们将回到属性管理，学习一个让 Python 代码更优雅、更安全的特性——@property 装饰器。
在第 42 天我们学习了 封装与私有属性，知道了如何隐藏数据。但如何安全地访问和修改这些私有数据呢？Java 程序员可能会写 get_xxx() 和 set_xxx() 方法，而 Python 程序员会使用 @property。
掌握它，你将写出既安全又"Pythonic"的代码！
一、什么是 @property 装饰器？
1. 定义
@property 是一个内置装饰器，它可以将类的方法转换为只读属性。调用者可以像访问普通属性一样访问该方法，无需添加括号 ()。
2. 核心优势
- 接口简洁：
obj.attr 比 obj.get_attr() 更简洁。 - 封装安全：可以在 getter/setter 中加入逻辑（如验证、计算），而调用者无感知。
- 重构友好：可以先用公有属性，后期改为 property，无需修改调用代码。
3. 基本示例
class Circle: def __init__(self, radius): self._radius = radius # 内部属性 @property def radius(self): """Getter: 像属性一样访问""" return self._radiusc = Circle(5)print(c.radius) # 5 (无需括号)# c.radius() # ❌ TypeError: 'int' object is not callable
💡 关键点：@property 让方法调用看起来像属性访问。二、完整用法：Getter, Setter, Deleter
@property 通常配合 .setter 和 .deleter 使用，实现对属性的完全控制。
1. 语法结构
class Class: @property def attr(self): # Getter 逻辑 return self._attr @attr.setter def attr(self, value): # Setter 逻辑（验证、赋值） self._attr = value @attr.deleter def attr(self): # Deleter 逻辑 del self._attr
2. 实战示例：温度转换
class Temperature: def __init__(self, celsius): self._celsius = celsius @property def celsius(self): return self._celsius @celsius.setter def celsius(self, value): if value < -273.15: raise ValueError("温度不能低于绝对零度") self._celsius = value @property def fahrenheit(self): """计算属性：只读""" return self._celsius * 1.8 + 32t = Temperature(25)print(t.celsius) # 25print(t.fahrenheit) # 77.0 (自动计算)t.celsius = 30 # 触发 setter# t.celsius = -300 # ❌ 抛出 ValueError# t.fahrenheit = 100 # ❌ AttributeError: 只读属性
三、核心应用场景
1. 数据验证（封装）
保护对象状态，防止非法赋值。这是 @property 最常见的用途。
class User: def __init__(self, name, age): self.name = name self.age = age # 触发 setter @property def age(self): return self._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 = valueu = User("Alice", 25)# u.age = -5 # ❌ 抛出 ValueError
2. 计算属性（Computed Property）
属性值不是存储的，而是动态计算的。节省内存，保证数据一致性。
class Rectangle: def __init__(self, width, height): self.width = width self.height = height @property def area(self): # 不存储 area，每次访问时计算 return self.width * self.height @property def perimeter(self): return 2 * (self.width + self.height)rect = Rectangle(5, 3)print(rect.area) # 15rect.width = 10print(rect.area) # 30 (自动更新)
3. 兼容旧代码（重构）
先将属性设为公有，后期需要验证时改为 property，无需修改调用者的代码。
# 版本 1：简单公有属性class Product: def __init__(self, price): self.price = price # 直接访问# 版本 2：需要验证，改为 propertyclass Product: def __init__(self, price): self.price = price # 调用代码无需修改 @property def price(self): return self._price @price.setter def price(self, value): if value < 0: raise ValueError("价格不能为负") self._price = value
四、@property vs Java Getter/Setter
特性 | Java 风格 | Python @property |
|---|
调用方式 | obj.getPrice(), obj.setPrice(100)
| obj.price, obj.price = 100
|
代码量 | 冗长（每个属性 2 个方法） | 简洁（装饰器语法） |
可读性 | 一眼看出是方法调用 | 像访问数据一样自然 |
灵活性 | 修改实现需改调用代码 | 修改实现无需改调用代码 |
💡 Python 哲学：简单优于复杂。如果不需要验证，直接用公有属性；如果需要，再用 @property。
五、常见误区与注意事项
1. 递归陷阱（最常见错误）⚠️
在 setter 中不要给同名属性赋值，否则会无限递归调用 setter。
class Wrong: @property def age(self): return self._age @age.setter def age(self, value): self.age = value # ❌ 递归！调用的是 setter 本身 # 应改为：self._age = valueclass Correct: @property def age(self): return self._age @age.setter def age(self, value): self._age = value # ✅ 操作内部属性
2. 避免副作用
Getter 应该只是返回数据，不要在其中修改对象状态或执行耗时操作（如网络请求）。
# ❌ 不推荐@propertydef data(self): self.count += 1 # 修改状态 return self._data# ✅ 推荐@propertydef data(self): return self._data
3. 不要过度使用
如果属性只是简单存储数据，不需要验证或计算，直接使用公有属性即可。不要为了“封装”而封装。
# ✅ 简单场景直接用公有属性class Point: def __init__(self, x, y): self.x = x # 不需要 property self.y = y
4. 内部属性命名 convention
通常使用单下划线 _attr 存储内部数据，表示“受保护”，配合 property 使用。
self._attr # 内部存储@propertydef attr(self): ... # 对外接口
六、实战练习
练习 1：实现安全的银行账户
创建一个 BankAccount 类，包含：
- 私有属性：
__balance (余额) - 属性：
balance (通过 property 访问) - 要求：
- 读取时返回余额。
- 存入时通过
deposit 方法。 - 不允许直接设置余额（只读）。
- 增加一个
info 属性，返回字符串描述。
class BankAccount: def __init__(self, balance=0): self.__balance = balance @property def balance(self): return self.__balance def deposit(self, amount): if amount > 0: self.__balance += amount @property def info(self): return f"账户余额：{self.balance} 元"acc = BankAccount(100)acc.deposit(50)print(acc.balance) # 150print(acc.info) # 账户余额：150 元# acc.balance = 200 # ❌ AttributeError: 只读属性
练习 2：实现华氏温度转换
创建一个 Temperature 类，支持 celsius 和 fahrenheit 双向转换。修改其中一个，另一个自动更新。
class Temperature: def __init__(self, celsius=0): self._celsius = celsius @property def celsius(self): return self._celsius @celsius.setter def celsius(self, value): self._celsius = value @property def fahrenheit(self): return self._celsius * 1.8 + 32 @fahrenheit.setter def fahrenheit(self, value): self._celsius = (value - 32) / 1.8t = Temperature(0)print(t.fahrenheit) # 32.0t.fahrenheit = 212print(t.celsius) # 100.0
七、总结
知识点 | 说明 |
|---|
@property
| 将方法转换为只读属性，调用无需括号 |
Getter | @property 装饰的方法，返回属性值
|
Setter | @attr.setter，支持赋值验证逻辑
|
Deleter | @attr.deleter，支持 del obj.attr
|
计算属性 | 动态计算值，不存储，保证一致性 |
递归陷阱 | Setter 中不要给同名属性赋值（用 _attr） |
最佳实践 | 简单属性直接用公有，需验证再用 property |
📌 明日预告：@staticmethod 静态方法
明天我们将进入 高级 OOP 特性第六天！
- 主题：
@staticmethod 静态方法 - 核心问题：
- 什么是静态方法？它与实例方法有什么区别？
- 静态方法的第一个参数是什么？（没有
self 或 cls） - 静态方法能访问实例属性或类属性吗？
- 实际应用场景有哪些？（工具函数、工厂方法）
- 它与模块级函数有什么区别？
💡 提前思考：如果有一个方法 add(x, y)，它不需要访问任何对象属性，应该定义为实例方法、类方法还是静态方法？
掌握 @property，让你的属性访问更安全、更优雅！继续加油！🚀
