最可靠、线程安全的单例实现是__new__+类变量锁,因双检锁保障竞态安全且支持继承;装饰器线程不安全、易绕过,模块级单例不支持继承,@staticmethod无法拦截实例化。

Python 中最可靠、线程安全的单例实现是用 __new__ + 类变量锁,而不是装饰器或模块级实例。
为什么不用装饰器或 @staticmethod?
装饰器(如常见 singleton 函数)在多线程下可能创建多个实例;@staticmethod 或 @classmethod 无法拦截实例化过程,容易被绕过(比如直接调用 object.__new__)。真正的单例必须控制 __new__ 的首次执行逻辑。
- 装饰器在类定义后才生效,无法阻止
MyClass().__init__()被重复调用 - 模块级单例(把实例写在模块顶层)看似简单,但无法支持继承——子类会共享父类实例,违反面向对象语义
- 使用
__dict__或__slots__模拟单例,会在多次初始化时覆盖状态,导致数据丢失
用 __new__ 实现线程安全单例
核心是在 __new__ 中检查类属性是否已存在实例,若无则创建并缓存;同时用 threading.Lock 防止竞态。注意:锁必须是类变量,且只在首次创建时加锁。
import threading
class Singleton:
_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防止多线程同时通过外层判断 - 必须用
super().__new__(cls),不能用object.__new__(cls),否则不支持继承链中的__new__重写 - 不要在
__init__中做初始化逻辑——它会在每次调用Singleton()时执行,应改用懒加载属性或显式init_once()
如果需要带参数的单例(如配置名)怎么办?
标准单例不允许传参给构造函数,因为第二次调用 Singleton(x=1) 时,__new__ 已返回已有实例,参数会被忽略,极易引发隐性 bug。正确做法是把参数作为实例属性初始化,或用工厂模式封装。
- 错误示例:
Singleton(db_url="sqlite:///a.db")→ 第二次调用时db_url不生效,但无报错 - 推荐方式:用类方法提供带参初始化入口,例如
Singleton.get_instance(db_url="..."),内部检查是否已初始化,未初始化则设置属性 - 更清晰的做法是放弃“构造即单例”,改用显式注册:先定义类,再由配置驱动创建唯一实例并绑定到模块变量
真正难的不是写对代码,而是让团队所有人理解:单例不是“只建一次”,而是“全局唯一可访问的实例”——这意味着它的状态必须可预测、可测试、不可被意外覆盖。一旦开始在 __init__ 里塞初始化逻辑,或者允许构造参数,就离坑不远了。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











