本文介绍如何避免手动拼接类属性字符串，通过重写 __str__ 方法或利用 __dict__ 实现简洁、可复用的属性组合输出。
本文介绍如何避免手动拼接类属性字符串，通过重写 `__str__` 方法或利用 `__dict__` 实现简洁、可复用的属性组合输出。
在 Python 开发中，经常需要将类实例的多个属性按特定格式组合成字符串（例如用于日志记录、导出或调试）。虽然可以直接使用 obj.attr1 + ";" + obj.attr2 这种硬编码方式，但这种方式缺乏可维护性、易出错且无法复用。更优雅的解决方案是借助 Python 的特殊方法机制或内置对象特性。
✅ 推荐方案：重写 __str__ 方法
__str__ 是 Python 的“字符串表示”协议方法，当调用 str(obj) 或 print(obj) 时自动触发。将其定义为返回格式化字符串，既语义清晰又符合 Python 惯例：
class Phone:
def __init__(self, brand, name):
self.brand = brand
self.name = name
def __str__(self):
return f"{self.brand};{self.name}"
phone = Phone("apple", "iphone3")
print(phone) # 输出：apple;iphone3
该方式优势明显：
- 明确表达“此对象的字符串形式应如何呈现”；
- 支持所有标准字符串上下文（如 f"Phone: {phone}"、logging.info(phone)）；
- 可轻松扩展逻辑（例如添加空值检查、字段顺序控制或分隔符参数）。
? 提示：若还需支持调试场景下的精确表示，可同时实现 __repr__（建议返回可执行的构造表达式，如 f"Phone(brand='{self.brand}', name='{self.name}')")。
⚠️ 备选方案（仅限简单场景）：动态拼接 __dict__.values()
对于属性结构固定、无计算属性（property）、无私有字段且顺序无关的简单类，可利用 __dict__ 获取所有实例属性字典：
phone_data = ";".join(phone.__dict__.values())
但需注意：
- __dict__ 返回的是无序字典（Python 3.7+ 保持插入顺序，但仍不推荐依赖）；
- 若类中存在方法、__slots__、@property 或其他非数据属性，可能引发错误或包含意外值；
- 属性名与值顺序不保证匹配业务逻辑（如 brand 应在前、name 在后），存在隐式耦合风险。
因此，该方法仅适用于教学演示或临时脚本，切勿用于生产环境。
总结
- 首选 __str__：语义明确、可控性强、符合 Python 哲学；
- 避免硬拼接：提升代码可读性与可维护性；
- 慎用 __dict__：虽简短但脆弱，易受类结构变更影响；
- 如需更灵活的格式化（如支持自定义分隔符、忽略空字段），可在 __str__ 中封装逻辑，例如：
def __str__(self, sep=";"):
parts = [self.brand, self.name]
return sep.join(filter(None, parts)) # 自动跳过 None 或空字符串
掌握这些技巧，能让类的设计更健壮、接口更友好。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
