掌握Python str方法（轻松理解对象的字符串表示）

主机测评网
Python
2025-12-04
897

在学习 Python __str__方法 的过程中，很多初学者常常感到困惑：为什么我们打印一个对象时，看到的是一串类似 <__main__.Person object at 0x...> 的内容？其实，通过自定义 __str__ 方法，我们可以让对象以更友好的方式展示自己。本文将带你从零开始深入理解这个重要的 Python魔术方法。

什么是 str 方法？

__str__ 是 Python 中的一个特殊方法（也叫“魔术方法”），它用于定义当对象被转换为字符串（例如使用 print() 或 str()）时应该返回什么内容。

默认情况下，如果你没有定义 __str__ 方法，Python 会使用其父类 object 中的默认实现，输出的是对象的内存地址信息，这对调试可能有用，但对用户不友好。

掌握Python __str__方法（轻松理解对象的字符串表示） Python __str__方法 Python字符串表示 Python对象打印 Python魔术方法第1张

基础示例：让对象“说话”

假设我们有一个 Person 类：

class Person:    def __init__(self, name, age):        self.name = name        self.age = age# 创建对象p = Person("张三", 25)print(p)  # 输出：<__main__.Person object at 0x...>

现在，我们为它添加 __str__ 方法：

class Person:    def __init__(self, name, age):        self.name = name        self.age = age    def __str__(self):        return f"姓名：{self.name}，年龄：{self.age}"# 创建对象p = Person("张三", 25)print(p)  # 输出：姓名：张三，年龄：25

看！现在打印对象时，显示的是我们自定义的友好信息。这就是 Python字符串表示 的魅力所在。

str 与 repr 的区别

你可能会听说另一个方法 __repr__，它也用于对象的字符串表示。两者有何不同？

__str__：面向最终用户，强调可读性。
__repr__：面向开发者，强调准确性，理想情况下应能通过返回值重新创建对象。

class Person:    def __init__(self, name, age):        self.name = name        self.age = age    def __str__(self):        return f"{self.name} ({self.age}岁)"    def __repr__(self):        return f"Person('{self.name}', {self.age})"p = Person("李四", 30)print(str(p))   # 李四 (30岁)print(repr(p))  # Person('李四', 30)

最佳实践建议

始终为你的类实现 __str__ 方法，提升代码可读性和用户体验。
如果可能，同时实现 __repr__，便于调试。
__str__ 应返回人类可读的字符串，避免包含技术细节。
不要在 __str__ 中执行耗时操作或引发异常。

总结

通过本文，你应该已经掌握了 Python __str__方法 的基本用法和设计思想。它是 Python对象打印 友好输出的关键，也是每个 Python 开发者必须了解的 Python魔术方法 之一。下次当你创建一个新类时，别忘了给它一个清晰、简洁的 __str__ 表示！

小提示：在 Jupyter Notebook 或交互式环境中，直接输入对象名会调用 __repr__，而使用 print() 才会调用 __str__。