Python 中 __new__的实现示例

 更新时间:2026年05月15日 09:02:25   作者:无风听海  
__new__是Python中负责分配并返回对象实例的方法,比__init__更早被调用,其主要区别在于调用时机、参数、返回值和职责,本文主要介绍了Python 中 __new__的实现示例,感兴趣的可以了解一下

__new__ 是 Python 中最底层的对象创建机制,它比 __init__ 更早被调用,真正负责分配并返回对象实例。理解它是掌握元类、单例、不可变类型定制等高级特性的基础。

一、__new__vs__init__的本质区别

class Foo:
    def __new__(cls, *args, **kwargs):
        print(f"[__new__] 分配内存,cls={cls}")
        instance = super().__new__(cls)  # 创建实例
        return instance                  # 必须 return!

    def __init__(self, value):
        print(f"[__init__] 初始化,self={self}")
        self.value = value

obj = Foo(42)
# [__new__] 分配内存,cls=<class 'Foo'>
# [__init__] 初始化,self=<__main__.Foo object>

关键区别:

__new____init__
调用时机实例创建之前实例创建之后
第一个参数cls(类本身)self(已有实例)
返回值必须返回实例必须返回 None
职责分配空间,构造对象初始化属性

__init__ 只有在 __new__ 返回了 cls 的实例时才会被调用。若返回其他类型,__init__ 会被跳过。

二、__new__的签名与调用链

object.__new__(cls[, *args, **kwargs])

Python 内部执行 Foo(42) 的等价逻辑是:

# type.__call__ 的内部行为(伪代码)
def __call__(cls, *args, **kwargs):
    obj = cls.__new__(cls, *args, **kwargs)
    if isinstance(obj, cls):        # 只有返回 cls 的实例才调 __init__
        obj.__init__(*args, **kwargs)
    return obj

下面是完整的对象创建生命周期:—

三、最重要的使用场景

1. 单例模式(Singleton)

class Singleton:
    _instance = None

    def __new__(cls, *args, **kwargs):
        if cls._instance is None:
            cls._instance = super().__new__(cls)
        return cls._instance  # 始终返回同一个实例

a = Singleton()
b = Singleton()
print(a is b)  # True

2. 定制不可变类型

strinttuple 等不可变类型必须在 __new__ 中完成初始化,因为一旦创建就无法修改:

class UpperStr(str):
    def __new__(cls, value):
        return super().__new__(cls, value.upper())
        # ⚠️ 不能在 __init__ 里改,str 是不可变的

s = UpperStr("hello")
print(s)        # HELLO
print(type(s))  # <class '__main__.UpperStr'>

3. 工厂模式 —— 根据参数返回不同类型

class Shape:
    def __new__(cls, kind, *args):
        subclasses = {"circle": Circle, "rect": Rect}
        target_cls = subclasses.get(kind, cls)
        return super().__new__(target_cls)

class Circle(Shape): pass
class Rect(Shape):   pass

s = Shape("circle")
print(type(s))  # <class '__main__.Circle'>

4. 元类(Metaclass)中的__new__

元类的 __new__ 控制类本身的创建(不是实例的创建):

class Meta(type):
    def __new__(mcs, name, bases, namespace):
        # 在类定义时,自动把所有方法名转大写
        new_ns = {k.upper() if not k.startswith('_') else k: v
                  for k, v in namespace.items()}
        return super().__new__(mcs, name, bases, new_ns)

class Foo(metaclass=Meta):
    def hello(self): return "hi"

Foo().HELLO()  # "hi"  — 方法被重命名了

四、常见陷阱

陷阱1:忘记 return

class Bad:
    def __new__(cls):
        super().__new__(cls)  # 没有 return!→ 返回 None
                              # __init__ 不会被调用,obj 是 None

陷阱2:__init__ 的参数必须与 __new__ 一致

# Python 会同时把参数传给 __new__ 和 __init__
# 若签名不匹配会报 TypeError

class Ok:
    def __new__(cls, x, y):      # 接受 x, y
        return super().__new__(cls)
    def __init__(self, x, y):    # 同样接受 x, y ✓
        self.x, self.y = x, y

陷阱3:super().__new__ 的参数

  • Python 3.3+ 后,object.__new__object.__init__ 中有一个接受了额外参数,另一个就会忽略多余参数(宽容机制)
  • 但自定义链中不要依赖这一行为,始终显式传递参数

五、__new__与__init_subclass__、__class_getitem__的关系

钩子触发时机典型用途
__new__每次实例化时控制实例创建
__init_subclass__定义子类时自动注册子类
__class_getitem__Foo[int] 语法泛型支持
元类 __new__定义类本身时修改类结构

总结

__new__ 的核心价值在于:在对象真正存在之前介入。当你需要控制的不是"对象初始化后的状态",而是"对象是哪个、是否创建、是什么类型"时,就该用 __new__。日常开发中最实用的三个场景是:单例、不可变类型继承、工厂方法

到此这篇关于Python 中 __new__的实现示例的文章就介绍到这了,更多相关Python __new__内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Python元编程声明与初始化定制元类实例探究

    Python元编程声明与初始化定制元类实例探究

    这篇文章主要为大家介绍了Python元编程声明与初始化定制元类实例探究,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2024-01-01
  • Django中处理出错页面的方法

    Django中处理出错页面的方法

    这篇文章主要介绍了Django中处理出错页面的方法,即在异常出现时返回的页面信息,需要的朋友可以参考下
    2015-07-07
  • python 爬取百度文库并下载(免费文章限定)

    python 爬取百度文库并下载(免费文章限定)

    这篇文章主要介绍了python 爬取百度文库并下载的示例,帮助大家更好的理解和学习python 爬虫的相关知识,感兴趣的朋友可以了解下
    2020-12-12
  • python操作excel的方法

    python操作excel的方法

    Openpyxl是一个常用的python库,用于对Excel的常用格式及其模板进行数据读写等操作。这篇文章主要介绍了python操作excel的方法,需要的朋友可以参考下
    2018-08-08
  • Python实现批量将PPT转换成长图

    Python实现批量将PPT转换成长图

    这篇文章主要为大家详细介绍了如何利用Python实现批量将PPT转换成长图,并且图片名称与PPT文件名称相同,保存位置相同,感兴趣的小伙伴可以了解下
    2023-08-08
  • python数据分析数据标准化及离散化详解

    python数据分析数据标准化及离散化详解

    这篇文章主要为大家详细介绍了python数据分析数据标准化及离散化,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-02-02
  • PyTorch的torch.cat用法

    PyTorch的torch.cat用法

    这篇文章主要介绍了PyTorch的torch.cat用法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-06-06
  • Python四大金刚之列表详解

    Python四大金刚之列表详解

    这篇文章主要介绍了Python的列表,小编觉得这篇文章写的还不错,需要的朋友可以参考下,希望能够给你带来帮助
    2021-10-10
  • python 创建一维的0向量实例

    python 创建一维的0向量实例

    今天小编就为大家分享一篇python 创建一维的0向量实例,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2019-12-12
  • python的迭代器,生成器和装饰器你了解吗

    python的迭代器,生成器和装饰器你了解吗

    这篇文章主要为大家详细介绍了python的迭代器,生成器和装饰器,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下,希望能够给你带来帮助
    2022-02-02

最新评论