本文详解如何在Python类中使用@property装饰器安全暴露属性，并结合str方法实现清晰、可控的字符串表示，避免直接访问实例变量带来的维护风险。
本文详解如何在python类中使用@property装饰器安全暴露属性，并结合__str__方法实现清晰、可控的字符串表示，避免直接访问实例变量带来的维护风险。
在Python面向对象编程中，直接将实例属性（如self.name）作为公有接口暴露给外部调用虽简单，但缺乏封装性与可扩展性——一旦后续需添加验证、日志或计算逻辑，所有调用点都需修改。更专业的做法是使用@property装饰器将属性访问转化为受控的方法调用，既保持语法简洁（obj.Owner），又保留逻辑干预能力。
以下是一个优化后的银行账户类示例：
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}'关键改进说明：
- ✅ 使用@property替代普通方法：Owner和Balance不再是可调用方法（如acct.owner()），而是像属性一样直接访问（acct.Owner），语义更清晰，且天然支持只读约束；
- ✅ 内部属性命名规范化：采用_name、_value命名，明确区分内部存储与对外接口，符合PEP 8惯例；
- ✅ __str__精准复用属性：__str__中直接引用self.Owner和self.Balance，确保字符串输出始终与最新业务逻辑一致；
- ✅ 类型提示增强可维护性：为参数和返回值添加类型注解，提升代码可读性与IDE支持；
- ✅ 格式化输出更专业：{self.Balance:.2f}保证金额保留两位小数，避免浮点显示误差（如100.4 → 100.40）。
⚠️ 注意事项：
提示词大师-python版
下载
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
立即学习“Python免费学习笔记（深入）”；
- 原问题中def balance(self): return self.balance存在递归调用错误（方法名与属性名冲突），应避免命名冲突；
- 若需支持赋值（如acct.Balance = 200），可补充@Balance.setter，但本例中余额应由业务方法（如deposit()/withdraw()）管理，故保持只读更安全；
- __str__仅用于用户友好展示，若需调试用的完整状态，请重写__repr__。
运行测试：
if __name__ == '__main__':
acct = Account("TomServo", 100.4)
print(acct)输出：
Account owner: TomServo Account balance: $100.40
这种设计兼顾了简洁性、安全性与可演化性，是Python中推荐的属性封装实践。
