最可靠、线程安全的单例实现是__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。正确做法是把参数作为实例属性初始化，或用工厂模式封装。
立即学习“Python免费学习笔记（深入）”；
- 错误示例：
Singleton(db_url="sqlite:///a.db")→ 第二次调用时db_url不生效，但无报错 - 推荐方式：用类方法提供带参初始化入口，例如
Singleton.get_instance(db_url="...")，内部检查是否已初始化，未初始化则设置属性 - 更清晰的做法是放弃“构造即单例”，改用显式注册：先定义类，再由配置驱动创建唯一实例并绑定到模块变量
真正难的不是写对代码，而是让团队所有人理解：单例不是“只建一次”，而是“全局唯一可访问的实例”——这意味着它的状态必须可预测、可测试、不可被意外覆盖。一旦开始在 __init__ 里塞初始化逻辑，或者允许构造参数，就离坑不远了。
