__new__是单例关键入口，因其实例创建第一关且在__init__前执行；必须在此拦截构造，否则__init__中判断已失效。
直接用 __new__ 实现单例，最稳妥的方式是加类级锁 + 双重检查，否则多线程下大概率失效。
为什么 __new__ 是单例的关键入口
__new__ 是实例创建的第一道关卡，在 __init__ 之前执行，且必须返回一个实例对象。单例的本质是“不让新实例被构造出来”，所以拦截点必须在这里——而不是靠 __init__ 里做标记或跳过初始化，那已经晚了。
常见错误是只在 __init__ 里判断是否已存在实例，结果每次调用 MyClass() 都会新建对象再丢弃，内存和初始化开销白费。
-
__new__必须显式返回cls的实例（通常是super().__new__(cls)），不能只写逻辑不返回 - 如果返回的不是
cls类型的实例，Python 不会调用__init__ - 子类继承时，
__new__的cls参数是当前子类，需注意是否要限制为“本类唯一”还是“整个继承树唯一”
基础版：线程不安全但够用的 __new__ 单例
适合脚本、CLI 工具或明确单线程环境：
class Config:
_instance = None
<pre class="brush:php;toolbar:false;">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__
解决并发问题，同时避免每次调用都加锁影响性能：
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
import threading
<p>class Database:
_instance = None
_lock = threading.Lock()</p><pre class="brush:php;toolbar:false;">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
<pre class="brush:php;toolbar:false;">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，而在于你是否意识到：单例的“唯一性”要贯穿整个对象生命周期，从内存分配、初始化、到并发访问，每个环节都可能漏掉一环。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
