Python中通过@property优雅访问类属性并自定义字符串表示

本文详解如何在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}'

关键要点说明：

柒源写作

降AI率；降重复率；一键初稿；一键图表

下载

• ✅ 命名规范：使用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的重要习惯。