1. Python 对象构造的双生子new与init的深度解析在 Python 的魔法方法世界里__new__和__init__就像一对性格迥异的双胞胎。很多刚接触面向对象编程的开发者会混淆它们的职责甚至认为它们是相互替代的关系。实际上这两个方法在对象生命周期中扮演着完全不同的角色。理解它们的区别是掌握 Python 对象创建机制的关键一步。我见过不少项目因为混淆这两个方法而导致内存泄漏或对象初始化异常。比如有人试图在__init__中实现单例模式结果发现每次都能创建新实例也有人误把资源分配代码写在__new__里导致对象状态不一致。本文将用实际代码示例带你彻底理清它们的区别并分享我在实际开发中总结的最佳实践。2. 本质区别创建者 vs 初始化者2.1new的构造者角色__new__是真正的对象创建者。当调用ClassName()时Python 首先调用的是类的__new__方法。这个方法必须返回一个实例对象通常是通过super().__new__(cls)调用父类的实现。class Example: def __new__(cls, *args, **kwargs): print(__new__ 被调用) instance super().__new__(cls) return instance关键点是静态方法不需要self参数第一个参数是cls当前类必须返回实例对象否则__init__不会执行常用于不可变类型子类化或单例模式2.2init的初始化者角色__init__在__new__返回实例后被调用负责初始化对象状态class Example: def __init__(self, value): print(__init__ 被调用) self.value value关键点是实例方法第一个参数是self不需要返回值返回 None可以多次调用通过obj.__init__()适合做属性赋值等初始化操作3. 执行顺序与协作机制3.1 完整的对象创建流程ClassName(*args, **kwargs)被调用Python 调用ClassName.__new__(cls, *args, **kwargs)如果__new__返回该类实例则调用__init__最终返回初始化后的对象class Demo: def __new__(cls, x): print(f__new__ 收到参数: {x}) instance super().__new__(cls) return instance def __init__(self, x): print(f__init__ 收到参数: {x}) self.x x obj Demo(42) # 输出: # __new__ 收到参数: 42 # __init__ 收到参数: 423.2 不返回实例的情况如果__new__返回非该类实例__init__不会执行class NoInit: def __new__(cls): return 我是一个字符串不是实例 def __init__(self): print(这行永远不会执行) obj NoInit() # 返回字符串不是 NoInit 实例4. 实际应用场景对比4.1new的典型用例单例模式实现class Singleton: _instance None def __new__(cls): if cls._instance is None: cls._instance super().__new__(cls) return cls._instance a Singleton() b Singleton() print(a is b) # True不可变类型子类化class UpperStr(str): def __new__(cls, value): return super().__new__(cls, value.upper()) s UpperStr(hello) # HELLO4.2init的典型用例常规对象初始化class DatabaseConnection: def __init__(self, host, port): self.host host self.port port self._connect() def _connect(self): print(f连接到 {self.host}:{self.port})动态属性设置class Config: def __init__(self, **kwargs): for k, v in kwargs.items(): setattr(self, k, v) config Config(debugTrue, timeout30)5. 高级技巧与注意事项5.1 元类中的new元类的__new__控制类的创建过程class Meta(type): def __new__(mcls, name, bases, namespace): print(f创建类 {name}) return super().__new__(mcls, name, bases, namespace) class MyClass(metaclassMeta): pass # 输出 创建类 MyClass5.2 避免的常见错误在new中访问实例属性class BadExample: def __new__(cls): self super().__new__(cls) self.x 1 # 不推荐应该在 __init__ 中做 return self忘记返回实例class NoReturn: def __new__(cls): print(忘记返回实例) obj NoReturn() # TypeError: __new__() 应该返回实例修改不可变对象class BadStr(str): def __init__(self, value): self.value value # 无效因为 str 是不可变类型5.3 性能考量__new__在每次实例化时都会被调用避免在其中做耗时操作对于大量创建的小对象可以考虑__slots__与__new__结合优化内存6. 实战案例自定义列表类型让我们实现一个会自动记录创建时间的列表import time class TimedList(list): def __new__(cls, *args, **kwargs): instance super().__new__(cls) instance.created_at time.time() # 在 __new__ 中添加时间戳 return instance def __init__(self, iterable): super().__init__(iterable) self.modified_at time.time() # 在 __init__ 中添加修改时间 lst TimedList([1, 2, 3]) print(lst.created_at) # 创建时间戳 print(lst.modified_at) # 初始化时间戳这个例子展示了如何合理分配__new__和__init__的职责__new__负责设置与实例化强相关的元信息__init__处理与初始化参数相关的逻辑。7. 调试技巧与问题排查当对象创建出现问题时可以通过这些方法排查检查__new__返回值def __new__(cls): instance super().__new__(cls) print(f创建的实例ID: {id(instance)}) return instance验证初始化顺序class OrderDemo: def __new__(cls): print(1. __new__ 开始) instance super().__new__(cls) print(2. __new__ 结束) return instance def __init__(self): print(3. __init__ 被调用)处理继承链问题 当多重继承时确保每个__new__都正确传递参数class BaseA: def __new__(cls, x): return super().__new__(cls) class BaseB: def __new__(cls, y): return super().__new__(cls) class Child(BaseA, BaseB): def __new__(cls, x, y): return super().__new__(cls, x) # 需要处理两个参数8. 最佳实践总结根据我在多个 Python 项目中的经验建议保持__new__简单只处理与实例创建直接相关的逻辑初始化放__init__所有属性设置、资源分配等放在这里注意不可变类型子类化str/tuple等必须用__new__修改值慎用单例模式全局状态会增加代码复杂度文档说明如果重写了__new__务必在文档中说明其行为对于大多数日常开发你可能不需要自己实现__new__。但理解它的工作原理能帮助你更好地理解 Python 对象模型并在需要实现特殊功能时游刃有余。 
长河君 · 2026/10/27 4:33:08 · 阅读 1.2k Python对象构造：__new__与__init__的区别与应用
1. Python 对象构造的双生子new与init的深度解析在 Python 的魔法方法世界里__new__和__init__就像一对性格迥异的双胞胎。很多刚接触面向对象编程的开发者会混淆它们的职责甚至认为它们是相互替代的关系。实际上这两个方法在对象生命周期中扮演着完全不同的角色。理解它们的区别是掌握 Python 对象创建机制的关键一步。我见过不少项目因为混淆这两个方法而导致内存泄漏或对象初始化异常。比如有人试图在__init__中实现单例模式结果发现每次都能创建新实例也有人误把资源分配代码写在__new__里导致对象状态不一致。本文将用实际代码示例带你彻底理清它们的区别并分享我在实际开发中总结的最佳实践。2. 本质区别创建者 vs 初始化者2.1new的构造者角色__new__是真正的对象创建者。当调用ClassName()时Python 首先调用的是类的__new__方法。这个方法必须返回一个实例对象通常是通过super().__new__(cls)调用父类的实现。class Example: def __new__(cls, *args, **kwargs): print(__new__ 被调用) instance super().__new__(cls) return instance关键点是静态方法不需要self参数第一个参数是cls当前类必须返回实例对象否则__init__不会执行常用于不可变类型子类化或单例模式2.2init的初始化者角色__init__在__new__返回实例后被调用负责初始化对象状态class Example: def __init__(self, value): print(__init__ 被调用) self.value value关键点是实例方法第一个参数是self不需要返回值返回 None可以多次调用通过obj.__init__()适合做属性赋值等初始化操作3. 执行顺序与协作机制3.1 完整的对象创建流程ClassName(*args, **kwargs)被调用Python 调用ClassName.__new__(cls, *args, **kwargs)如果__new__返回该类实例则调用__init__最终返回初始化后的对象class Demo: def __new__(cls, x): print(f__new__ 收到参数: {x}) instance super().__new__(cls) return instance def __init__(self, x): print(f__init__ 收到参数: {x}) self.x x obj Demo(42) # 输出: # __new__ 收到参数: 42 # __init__ 收到参数: 423.2 不返回实例的情况如果__new__返回非该类实例__init__不会执行class NoInit: def __new__(cls): return 我是一个字符串不是实例 def __init__(self): print(这行永远不会执行) obj NoInit() # 返回字符串不是 NoInit 实例4. 实际应用场景对比4.1new的典型用例单例模式实现class Singleton: _instance None def __new__(cls): if cls._instance is None: cls._instance super().__new__(cls) return cls._instance a Singleton() b Singleton() print(a is b) # True不可变类型子类化class UpperStr(str): def __new__(cls, value): return super().__new__(cls, value.upper()) s UpperStr(hello) # HELLO4.2init的典型用例常规对象初始化class DatabaseConnection: def __init__(self, host, port): self.host host self.port port self._connect() def _connect(self): print(f连接到 {self.host}:{self.port})动态属性设置class Config: def __init__(self, **kwargs): for k, v in kwargs.items(): setattr(self, k, v) config Config(debugTrue, timeout30)5. 高级技巧与注意事项5.1 元类中的new元类的__new__控制类的创建过程class Meta(type): def __new__(mcls, name, bases, namespace): print(f创建类 {name}) return super().__new__(mcls, name, bases, namespace) class MyClass(metaclassMeta): pass # 输出 创建类 MyClass5.2 避免的常见错误在new中访问实例属性class BadExample: def __new__(cls): self super().__new__(cls) self.x 1 # 不推荐应该在 __init__ 中做 return self忘记返回实例class NoReturn: def __new__(cls): print(忘记返回实例) obj NoReturn() # TypeError: __new__() 应该返回实例修改不可变对象class BadStr(str): def __init__(self, value): self.value value # 无效因为 str 是不可变类型5.3 性能考量__new__在每次实例化时都会被调用避免在其中做耗时操作对于大量创建的小对象可以考虑__slots__与__new__结合优化内存6. 实战案例自定义列表类型让我们实现一个会自动记录创建时间的列表import time class TimedList(list): def __new__(cls, *args, **kwargs): instance super().__new__(cls) instance.created_at time.time() # 在 __new__ 中添加时间戳 return instance def __init__(self, iterable): super().__init__(iterable) self.modified_at time.time() # 在 __init__ 中添加修改时间 lst TimedList([1, 2, 3]) print(lst.created_at) # 创建时间戳 print(lst.modified_at) # 初始化时间戳这个例子展示了如何合理分配__new__和__init__的职责__new__负责设置与实例化强相关的元信息__init__处理与初始化参数相关的逻辑。7. 调试技巧与问题排查当对象创建出现问题时可以通过这些方法排查检查__new__返回值def __new__(cls): instance super().__new__(cls) print(f创建的实例ID: {id(instance)}) return instance验证初始化顺序class OrderDemo: def __new__(cls): print(1. __new__ 开始) instance super().__new__(cls) print(2. __new__ 结束) return instance def __init__(self): print(3. __init__ 被调用)处理继承链问题 当多重继承时确保每个__new__都正确传递参数class BaseA: def __new__(cls, x): return super().__new__(cls) class BaseB: def __new__(cls, y): return super().__new__(cls) class Child(BaseA, BaseB): def __new__(cls, x, y): return super().__new__(cls, x) # 需要处理两个参数8. 最佳实践总结根据我在多个 Python 项目中的经验建议保持__new__简单只处理与实例创建直接相关的逻辑初始化放__init__所有属性设置、资源分配等放在这里注意不可变类型子类化str/tuple等必须用__new__修改值慎用单例模式全局状态会增加代码复杂度文档说明如果重写了__new__务必在文档中说明其行为对于大多数日常开发你可能不需要自己实现__new__。但理解它的工作原理能帮助你更好地理解 Python 对象模型并在需要实现特殊功能时游刃有余。