本文详解如何在python类中正确实现属性访问机制，避免方法调用错误，并利用@property将数据获取逻辑封装为直观、安全的属性接口，同时保持__str__等特殊方法的可读性与实用性。
本文详解如何在python类中正确实现属性访问机制，避免方法调用错误，并利用@property将数据获取逻辑封装为直观、安全的属性接口，同时保持__str__等特殊方法的可读性与实用性。
在Python面向对象编程中，直接暴露实例变量（如self.name）虽简单，但缺乏控制力；而定义普通方法（如owner()）又需显式调用括号，违背“属性即数据”的直觉。更关键的是，原代码中存在一个典型错误：def balance(self): return self.balance——该方法无限递归调用自身，将引发RecursionError，而非返回预期的余额值。
正确的解决方案是使用@property装饰器，将获取逻辑封装为只读属性，既保持语法简洁（无需()），又支持在str等方法中自然引用，还能为未来添加验证、日志或懒加载逻辑预留扩展空间。
以下是优化后的完整实现：
class Account:
def __init__(self, name: str, value: float):
self.name = name
self.value = value
@property
def owner(self) -> str:
"""返回账户持有人姓名（只读属性）"""
return self.name
@property
def balance(self) -> float:
"""返回账户余额（只读属性）"""
return self.value
def __str__(self) -> str:
return f'Account owner: {self.owner}\nAccount balance: ${self.balance:.2f}'
使用示例：
if __name__ == '__main__':
acct = Account("TomServo", 100.40)
print(acct) # 调用 __str__
print(acct.owner) # 直接访问属性，无括号
print(acct.balance) # 同上，安全且语义清晰
输出结果：
Account owner: TomServo Account balance: $100.40 TomServo 100.4
⚠️ 注意事项：
- 避免在str中直接拼接未处理的原始数据（如浮点数精度问题），建议使用格式化（如{self.balance:.2f}）提升可读性；
- 若后续需支持修改属性，可配合@balance.setter定义赋值逻辑，并加入类型/范围校验；
- 属性名应使用小写字母加下划线（PEP 8规范），如owner优于Owner，增强一致性与可维护性；
- 普通方法（如原owner()）与@property不可同名，否则会覆盖导致运行时错误。
通过@property，你不仅修复了递归错误，更将类接口设计得更符合Python惯用法：简洁、明确、可扩展。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
