直接用类变量 _instance 实现单例易出错，因未加锁时多线程可能同时通过 if cls._instance is None 判断，导致重复创建实例；Python 的 GIL 不保证 _instance 赋值与对象初始化的原子性，必须用 threading.Lock 配合双重检查锁定才能确保线程安全。
为什么直接用类变量实现 _instance 容易出错？
很多人写单例第一反应是加个 _instance 类变量，在 __new__ 里判断是否已存在。问题在于：没考虑多线程场景下两个线程同时走到 if not cls._instance: 分支，结果创建了两个实例。Python 的 GIL 虽能缓解部分竞争，但不保证原子性——尤其在 __new__ 中涉及对象构造时，_instance 赋值和实际对象初始化不是原子操作。
实操建议：
- 必须加锁，推荐用
threading.Lock，不要用threading.RLock（没必要且有开销） - 锁粒度要小：只锁实例创建那段，别把整个
__new__都包进去 - 避免在模块导入时就触发单例初始化（比如在类定义体里调
getInstance()），否则可能引发循环依赖
用 __new__ + threading.Lock 的最小可靠实现
这是最可控、兼容性最好（支持继承、支持 __init__ 参数）的方式。关键点不是“怎么写”，而是“哪几行不能动”：
import threading
<p>class Singleton:
_instance = None
_lock = threading.Lock()</p><pre class="brush:php;toolbar:false;">def __new__(cls, *args, **kwargs):
if cls._instance is None:
with cls._lock:
if cls._instance is None: # 双重检查
cls._instance = super().__new__(cls)
return cls._instance
def __init__(self, value=None):
# 注意：__init__ 可能被多次调用！需自行控制
if not hasattr(self, '_initialized'):
self.value = value
self._initialized = True
常见错误现象：__init__ 被反复执行（因为每次调 Singleton(x) 都会进 __init__）。所以要用 hasattr(self, '_initialized') 这类标记，而不是依赖 _instance 是否为 None。
装饰器方式 vs 元类方式：选哪个？
装饰器（如 @singleton）看着简洁，但实际限制多：
- 无法继承：被装饰的类不能再被其他类继承（装饰器返回的是函数或新类，破坏了原类的 MRO）
- 不支持带参数的初始化：装饰器通常只作用于类本身，
Singleton(123)传参后无法透传给底层逻辑 - 调试困难：堆栈里看到的是装饰器生成的 wrapper，不是原始类
元类（metaclass=SingletonMeta）更底层，能统一控制所有子类行为，但代价是：
- 新手难理解
__call__在元类里的含义 - 与某些框架（如 Django Model、attrs）冲突概率高
- 一旦设错
__new__或__call__，整个继承链失效，且报错位置隐蔽
结论：除非你在写通用框架库，否则优先用 __new__ 方式。它显式、可 debug、不污染命名空间。
单例和 __init__ 参数：为什么不能靠构造函数参数做状态区分？
有人想让 Singleton('db1') 和 Singleton('db2') 返回不同实例——这已经不是单例，是对象池或注册表模式。单例的核心约束是「全局唯一」，参数只能用于首次初始化，后续调用应忽略或报错。
实操建议：
- 首次调用传参后，记录参数并校验后续调用是否一致；不一致就抛
ValueError - 若真需要多个配置实例，改用工厂函数：
get_database(name='default')，内部缓存不同name对应的实例 - 避免在
__init__里做耗时操作（如连接数据库），应延迟到第一次使用时（懒加载），否则 import 时就卡住
最容易被忽略的是：单例对象的生命周期和模块生命周期绑定。如果模块被 reload（比如开发时用 importlib.reload），_instance 不会自动清空，旧实例仍驻留内存——这时候得手动重置 _instance = None，否则测试会出诡异问题。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
