在Python的面向对象编程体系里,__new__和__init__是两个和类实例化密切相关的特殊方法,很多初学者会误以为二者作用相同,实际上它们在实例创建的全流程中承担着完全不同的职责,执行顺序和生效逻辑也有明确区分。

__new__与__init__的基础执行机制
要理解二者的关系,首先要明确Python类实例化的完整流程:当调用类的构造方法创建实例时,解释器会先执行__new__方法,再执行__init__方法,二者的分工非常清晰。
__new__方法的作用
__new__是一个类方法,它的核心职责是创建并返回类的实例对象。它接收的第一个参数是类本身,通常我们用cls作为参数名,后续参数会传递给__init__方法。默认情况下,所有新式类都继承自object,object的__new__方法会完成实例内存分配的基础工作。
下面是一个基础的__new__使用示例:
class DemoClass:
def __new__(cls, *args, **kwargs):
print("执行__new__方法,开始创建实例")
# 调用父类object的__new__方法创建实例
instance = super().__new__(cls)
return instance
def __init__(self, name):
print("执行__init__方法,开始初始化实例")
self.name = name
# 创建实例
obj = DemoClass("test")
print(obj.name)
运行上述代码会先输出执行__new__方法,开始创建实例,再输出执行__init__方法,开始初始化实例,最后输出test,这直接证明了__new__的执行顺序在__init__之前。
__init__方法的作用
__init__是实例初始化方法,它接收的第一个参数是已经创建好的实例对象,通常我们用self作为参数名。它的职责是给实例绑定属性、完成初始化逻辑,但是__init__方法不需要返回值,即使返回了非None的值也会被解释器忽略。
二者的核心差异对比
为了更清晰地区分二者,我们可以从多个维度做对比:
| 对比维度 | __new__方法 | __init__方法 |
|---|---|---|
| 执行顺序 | 先执行 | 后执行 |
| 第一个参数 | cls(类本身) | self(已创建的实例) |
| 核心职责 | 创建并返回实例对象 | 初始化实例属性 |
| 返回值要求 | 必须返回实例对象,否则__init__不会执行 | 无返回值要求,返回非None值也会被忽略 |
常见使用陷阱及规避方法
在实际开发中,很多开发者会因为对二者机制理解不到位踩坑,下面列举几个最常见的陷阱。
陷阱1:__new__没有返回实例导致__init__不执行
如果__new__方法没有返回任何对象,或者返回的不是当前类的实例,那么__init__方法不会被调用,这是很多初学者容易犯的错误。
看下面的错误示例:
class ErrorClass:
def __new__(cls, *args, **kwargs):
print("执行__new__,但是没有返回实例")
# 这里没有return语句,相当于返回None
def __init__(self, name):
print("执行__init__")
self.name = name
# 创建实例
obj = ErrorClass("test")
print(obj) # 输出None,因为__new__没有返回实例,__init__也没有执行
规避方法很简单:重写__new__时,一定要确保调用父类的__new__方法并返回得到的实例对象,除非你有特殊的设计需求。
陷阱2:__new__返回其他类的实例
如果__new__返回的不是当前类的实例,而是其他类的实例,那么解释器会直接把这个返回的对象作为实例化结果,不会调用当前类的__init__方法。
class ClassA:
def __init__(self):
print("ClassA的__init__执行")
class ClassB:
def __new__(cls, *args, **kwargs):
# 返回ClassA的实例
return ClassA()
def __init__(self):
print("ClassB的__init__执行")
obj = ClassB()
print(type(obj)) # 输出<class '__main__.ClassA'>,ClassB的__init__没有执行
这种特性其实可以用来实现单例模式、工厂模式等设计,但是如果不清楚这个机制,很容易写出不符合预期的代码。
陷阱3:__new__和__init__的参数不匹配
因为__new__的*args和**kwargs会传递给__init__,如果二者接收的参数不匹配,就会抛出类型错误。
class ParamErrorClass:
def __new__(cls, a, b):
# __new__只接收a和b两个参数
instance = super().__new__(cls)
return instance
def __init__(self, a, b, c):
# __init__需要a、b、c三个参数,但是__new__只传了a和b
self.a = a
self.b = b
self.c = c
# 创建实例时会报错:__init__() missing 1 required positional argument: 'c'
obj = ParamErrorClass(1, 2)
规避方法:如果重写了__new__方法,尽量让它的参数列表和__init__保持一致,或者统一使用*args和**kwargs接收参数,避免参数不匹配的问题。
陷阱4:在__new__中给实例绑定属性
虽然__new__中也可以给创建的实例绑定属性,但是不建议这么做,因为属性的初始化逻辑应该统一放在__init__中,这样代码的可读性和可维护性会更好。如果同时在__new__和__init__中操作同一个属性,很容易出现逻辑混乱。
典型应用场景
除了基础的实例化流程,二者还有一些典型的应用场景:
- 实现单例模式:重写
__new__方法,判断类是否已经有实例,如果有就直接返回已有实例,没有再创建新实例。 - 不可变类型的子类化:比如自定义
int、str的子类时,需要在__new__中完成值的处理,因为不可变类型的值在创建后不能修改,__init__无法修改其值。 - 工厂模式:在
__new__中根据传入的参数返回不同类的实例,实现灵活的实例创建逻辑。
下面是一个简单的单例模式实现示例:
class Singleton:
_instance = None
def __new__(cls, *args, **kwargs):
if cls._instance is None:
cls._instance = super().__new__(cls)
return cls._instance
def __init__(self, name):
self.name = name
# 测试单例
obj1 = Singleton("first")
obj2 = Singleton("second")
print(obj1 is obj2) # 输出True,两个变量指向同一个实例
print(obj1.name) # 输出second,因为第二次实例化时__init__仍然会执行,修改了实例的属性
需要注意的是,上述单例实现中,每次调用构造方法都会执行__init__,如果需要避免重复初始化,可以在__init__中加一个初始化标记来判断。