不是只有 print() 才会触发 __str__，但 print() 是最常见的触发场景

• 内置函数 format(obj) / f-string → 默认走 __format__，但如果不指定格式，也会回落到 str(obj)，于是间接调用 __str__，

  f"{obj}" 不指定格式		隐式 str(obj)
  "{0}".format(obj)		同上

• 日志模块 logging.info("%s", obj)

  内部 str(obj)

• 内置函数 str(obj) → 直接调用 obj.__str__()

• print(obj) → 内部调用 str(obj) → 调用 obj.__str__()

  • 在 CPython 里，所有最终想把“任意对象”变成字符串的公开 API（str()、f-string、"{}".format(obj)、日志里的 %s 等）都会走到同一条 C 级函数：PyObject_Str。
  • PyObject_Str 的伪代码逻辑就是
    1. 如果 type(obj)->tp_str 非空 → 直接调用 obj.__str__()
    2. 否则走默认路径（object.__str__，生成 <__main__.Foo object at 0x...>）
       因而可以认为：最终底层确实都是一次 str() 行为，再调用 __str__。

    3. str(obj)
       字节码只有一条：
       LOAD_NAME    0 (obj)
       CALL_FUNCTION 1 (str)
       
       CPython 内部 builtin_str → PyObject_Str(obj) → obj.__str__()
       
       这是 C 语言 的写法，不是 Python。
       type(obj) 在 CPython 的 C API 里是一个指向“类型对象”的指针，->tp_str 就是去取这个类型对象里的一个字段，名字叫 tp_str，它保存着指向该类型的 __str__ 实现函数的指针。
       逐字解释：
       type(obj)
       在 C 层等价于 obj.__class__（拿到“类型对象”）。
       type(obj)->tp_str
       用 C 的“箭头运算符” -> 访问结构体成员，相当于
       obj.__class__.__dict__.get("__str__") 的 C 版本，只不过这里取出来的是 C 函数指针。
       如果这个指针非空（即类里真正定义了 __str__），就直接调用它；
       如果是空指针（没有自定义 __str__），就回落到 object.__str__。
       
       f-string f'prefix{obj}'
       编译期把 f-string 拆成 CONST + FORMAT_VALUE：
       LOAD_CONST    'prefix'
       LOAD_NAME     0 (obj)
       FORMAT_VALUE  0        # 0 表示默认格式
       BUILD_STRING  2
       
       FORMAT_VALUE 的 C 实现：
       if (fmt_spec == NULL)
           res = PyObject_Str(value);   // 直接调用 __str__
       
       日志 logging.info("%s", obj)
       logging 内部通过 Formatter → record.getMessage() → msg % args → 最终 PyUnicode_Format → PyObject_Str(obj)。

        

• 只要没有显式或隐式地调用 str(obj)，就不会触发 __str__
• __repr__ 只在需要“官方字符串表示”时被调用（交互式回显、repr(obj)、调试器显示等）

PyObject_Str 是 C 语言级别的运行时函数（在 Objects/object.c 里），永远也不会出现在 Python 字节码里。

表格