### Python 中 `__str__()` 方法未被调用的原因及解决办法 当在 Python 中定义了一个类并希望其对象能够通过 `print` 或其他方式返回自定义的字符串表示时，通常会重写 `__str__()` 方法。然而，在某些情况下可能会发现即使定义了 `__str__()` 方法，它也并未按预期工作。 #### 原因分析 1. **缺少 `return` 关键字** 如果在 `__str__()` 方法中仅使用 `print` 而没有 `return` 返回值，则该方法不会生效。这是因为 `print` 只负责向标准输出打印内容，而并不会改变对象本身的字符串表示形式[^2]。 2. **优先级问题** 当既定义了 `__str__()` 和 `__repr__()` 方法时，`__str__()` 的优先级高于 `__repr__()`。但如果未显式调用 `print(obj)` 或者将对象转换为字符串（如 `str(obj)`），则可能触发 `__repr__()` 方法而不是 `__str__()` 方法[^1]。 3. **错误的对象上下文** 在一些特定场景下（例如调试工具或交互式环境中），Python 默认调用的是 `__repr__()` 方法而非 `__str__()` 方法。因此，如果只定义了 `__str__()` 而未定义 `__repr__()`，可能导致行为不符合预期[^4]。 #### 解决方案 以下是几种常见的解决方案： 1. **确保 `__str__()` 方法中有 `return` 语句** 修改代码如下所示： ```python class Cat: def __init__(self, name, age): self.name = name self.age = age def __str__(self): return f"{self.name}, {self.age}" # 使用 return 返回字符串 tom = Cat("Tom", 18) print(tom) # 输出 Tom, 18 ``` 2. **同时实现 `__repr__()` 方法** 定义 `__repr__()` 方法可以作为备用机制，尤其是在调试或其他特殊环境下。以下是一个例子： ```python class Nothing: def __init__(self, name='Afric', age=20): self.name = name self.age = age def __str__(self): return f"Nothing(name={self.name}, age={self.age})" def __repr__(self): return f"<Object of type '{type(self).__name__}' with attributes: name='{self.name}', age={self.age}>" obj = Nothing() print(repr(obj)) # 输出 <Object of type 'Nothing' with attributes: name='Afric', age=20> print(str(obj)) # 输出 Nothing(name=Afric, age=20) ``` 3. **检查调用环境** 确认当前使用的函数是否会自动调用 `__str__()` 方法。例如，`format()` 函数也会尝试调用 `__str__()` 来获取对象的字符串表示[^5]。 #### 示例代码 下面提供一个完整的示例，展示如何正确实现和测试 `__str__()` 方法： ```python class Person: def __init__(self, name, age): self.name = name self.age = age def __str__(self): return f"Person: Name={self.name}, Age={self.age}" person = Person("Alice", 30) print(person) # 正确输出：Person: Name=Alice, Age=30 ``` --- ###