Python单例模式：\_\_new\_\_实现唯一实例

本文深入剖析了Python中通过`__new__`方法实现单例模式的核心原理与实战要点，强调`__new__`作为实例创建的第一道关卡不可替代——唯有在此拦截才能真正阻止多余实例的诞生，而仅靠`__init__`判断纯属亡羊补牢；文章直击常见误区（如falsy值误判、GIL幻觉、`__init__`重复执行），详解线程不安全的基础写法与生产级双重检查锁（DCL）方案，并提醒继承场景、参数化初始化及惰性初始化等高阶陷阱，帮你避开那些看似能跑、实则崩在高并发或复杂继承链上的“伪单例”。

直接用 __new__ 实现单例，最稳妥的方式是加类级锁 + 双重检查，否则多线程下大概率失效。

为什么 __new__ 是单例的关键入口

__new__ 是实例创建的第一道关卡，在 __init__ 之前执行，且必须返回一个实例对象。单例的本质是“不让新实例被构造出来”，所以拦截点必须在这里——而不是靠 __init__ 里做标记或跳过初始化，那已经晚了。

常见错误是只在 __init__ 里判断是否已存在实例，结果每次调用 MyClass() 都会新建对象再丢弃，内存和初始化开销白费。

• __new__ 必须显式返回 cls 的实例（通常是 super().__new__(cls)），不能只写逻辑不返回
• 如果返回的不是 cls 类型的实例，Python 不会调用 __init__
• 子类继承时，__new__ 的 cls 参数是当前子类，需注意是否要限制为“本类唯一”还是“整个继承树唯一”

基础版：线程不安全但够用的 __new__ 单例

适合脚本、CLI 工具或明确单线程环境：

class Config:
    _instance = None
def __new__(cls):
    if cls._instance is None:
        cls._instance = super().__new__(cls)
    return cls._instance

问题很直接：并发调用 Config() 时，两个线程可能同时判断 _instance is None 成立，各自执行 super().__new__(cls)，最终生成两个实例。

• 不要用 if not cls._instance，因为 _instance 可能是 False、0 等 falsy 值，误判
• 类变量 _instance 必须初始化为 None，不能留空或用 ...
• 这个写法对继承不友好——子类调用时会共享父类的 _instance，除非显式重置

生产可用版：带双重检查锁的 __new__

解决并发问题，同时避免每次调用都加锁影响性能：

import threading
class Database:
_instance = None
_lock = threading.Lock()
def __new__(cls):
    if cls._instance is None:
        with cls._lock:
            if cls._instance is None:
                cls._instance = super().__new__(cls)
    return cls._instance

这就是标准的双重检查锁定（Double-Checked Locking）。外层 if 减少锁竞争，内层 if 防止多个线程在持锁时重复创建。

• _lock 必须是类变量，且用 threading.Lock() 初始化，不能在 __new__ 里临时创建
• Python 的 GIL 不能替代显式锁——GIL 只保证原子字节码不被打断，而 if 判断和赋值是两步操作
• 如果单例需要支持参数化初始化（比如 Database(url=...)），__new__ 无法传参给父类构造器，得配合 __init__ 做惰性初始化，且仍需加锁

容易被忽略的坑：__init__ 会被反复调用

即使 __new__ 返回了已有实例，Python 默认仍会调用 __init__。这意味着下面的代码会打印两次 “init called”：

class Logger:
    _instance = None
def __new__(cls):
    if cls._instance is None:
        cls._instance = super().__new__(cls)
    return cls._instance

def __init__(self):
    print("init called")  # ← 这里会执行两次

解决方法只有两个：要么在 __init__ 里加守卫，要么彻底禁用多次初始化逻辑。

• 推荐在 __init__ 开头加 if hasattr(self, '_initialized') and self._initialized: return
• 或者把初始化逻辑全挪到 __new__ 中（但要注意此时不能访问实例属性）
• 别依赖 isinstance(self, cls) 做判断——它永远为真，没意义

真正的难点从来不在怎么写第一行 if cls._instance is None，而在于你是否意识到：单例的“唯一性”要贯穿整个对象生命周期，从内存分配、初始化、到并发访问，每个环节都可能漏掉一环。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。