本文详解如何在Python类中使用@property装饰器安全暴露属性，并结合str方法实现清晰、可读的实例打印效果，避免直接暴露内部变量或方法调用错误。
本文详解如何在python类中使用@property装饰器安全暴露属性，并结合__str__方法实现清晰、可读的实例打印效果，避免直接暴露内部变量或方法调用错误。
在Python面向对象编程中，合理封装数据与行为是关键实践。当需要让类实例以人类可读的方式输出特定字段（如账户名、余额），同时又希望外部代码能以简洁、一致的方式访问这些值时，直接定义普通方法（如owner()）虽可行，但存在两个典型问题：一是调用语法冗余（acct.owner()），二是易与内部逻辑混淆；更严重的是，原示例中balance()方法错误地递归调用了自身（return self.balance），导致RecursionError。
此时，@property装饰器是最佳解决方案——它将方法“伪装”为只读属性，既保持封装性，又提供自然的点号访问语法（acct.Owner），且支持在str中直接引用，大幅提升可读性与健壮性。
以下是一个优化后的完整示例：
class Account:
def __init__(self, name: str, value: float):
self.name = name
self.value = value
@property
def Owner(self) -> str:
"""返回账户持有人姓名（首字母大写命名风格，体现公共API语义）"""
return self.name
@property
def Balance(self) -> float:
"""返回账户余额（避免与实例方法balance()混淆）"""
return self.value
def __str__(self) -> str:
return f'Account owner: {self.Owner}\nAccount balance: ${self.Balance:.2f}'
关键要点说明：
- ✅ 命名规范：使用Owner和Balance（PascalCase）明确标识其为公共属性接口，区别于私有字段self.name和self.value；
- ✅ 类型提示：增强代码可维护性，明确参数与返回值类型；
- ✅ 格式化输出：{self.Balance:.2f}确保金额保留两位小数，避免浮点精度显示问题；
- ❌ 避免陷阱：原代码中def balance(self): return self.balance是经典递归错误，而@property天然规避此风险；
- ? 测试验证：
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
进阶建议：
若需支持余额修改，可为Balance添加@Balance.setter；若需严格校验（如禁止负余额），可在setter中加入条件判断。但对只读场景，仅使用@property即可兼顾简洁性与安全性。
总之，善用@property不仅解决打印需求，更是构建清晰、可靠Python API的重要习惯。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
