Python 类里 init 和 new 到底哪个先执行?

new 总是比 init 先执行,它负责创建并返回实例,仅当返回本类实例时 init 才被调用;返回其他类型则跳过 __init__。

__new__ 总是比 __init__ 先执行

Python 实例化对象时,__new__ 是第一个被调用的特殊方法,它负责创建并返回一个类的实例;只有当 __new__ 返回了当前类的实例(或其子类实例)后,__init__ 才会被自动调用进行初始化。如果 __new__ 返回的是其他类型对象(比如 strint 或另一个类的实例),__init__ 根本不会触发。

什么时候必须重写 __new__?

__new__ 通常只在需要控制对象创建过程时才重写,比如单例模式、不可变类型子类、或基于参数动态返回不同类实例的工厂逻辑。普通业务类几乎不需要碰它——误改 __new__ 容易导致 __init__ 不执行、实例属性未初始化、甚至静默失败。

  • 单例:检查类变量是否已有实例,有则直接返回,不调用 __init__
  • 继承 tuple/str 等不可变类型时,必须在 __new__ 中完成值构造,因为 __init__ 无法修改已创建的不可变对象
  • 返回 None 或非本类实例 → __init__ 被跳过,且可能引发 TypeError: object.__init__()

    takes exactly one argument

__new__ 和 __init__ 的参数差异很关键

__new__ 的第一个参数是 cls(类本身),后续参数需与 __init__ 保持一致(否则实例化时会报 TypeError),但它**必须显式返回一个实例**;而 __init__ 的第一个参数是 self(已创建的实例),它不需要返回值(返回值会被忽略)。

class A:
    def __new__(cls, x):
        print("__new__ called")
        instance = super().__new__(cls)
        return instance  # 必须返回!否则 __init__ 不执行
def __init__(self, x):
    print("__init__ called")
    self.x = x

若把 return instance 换成 return "hello",则 __init__ 不会运行,且 A(1) 的结果是字符串 "hello",不是 A 实例。

调试时怎么确认哪个没走?

最直接的方式是在两个方法里加 print 或日志。但要注意:如果 __new__ 返回了错误类型,你可能看到 __new__ 执行了,但 __init__ 没反应——这不是 bug,是 Python 的正常行为。常见误判点:

  • 以为 __init__ “应该”总被执行 → 忘记检查 __new__ 的返回值类型
  • __new__ 里调用了 super().__new__(cls) 却没返回它 → 实际返回 None,导致后续静默失败
  • 重写 __new__ 时漏传参数给父类,如 super().__new__(cls) 写成 super().__new__(cls, x) → 报错,因为 object.__new__ 不接受额外参数

真正容易出问题的,往往不是“谁先谁后”,而是 __new__ 返回了什么——这点在写元类或自定义序列类型时尤其容易踩空。