直接用 new 实现单例在多线程下会出问题，因为多个线程可能同时通过 if not cls._instance 检查并各自创建实例，导致返回不同对象，形成“竞态单例”。
为什么直接用 __new__ 实现单例在多线程下会出问题
因为多个线程可能同时执行到 if not cls._instance: 这一行，都发现 _instance 是 None，于是各自调用 super().__new__(cls) 创建新实例，最终返回不同对象。这不是单例，而是“竞态单例”。
常见现象：明明只调用了两次 MySingleton()，但 id(obj1) != id(obj2)，或者日志里看到初始化逻辑被执行了多次。
- Python 的 GIL 不能保证类构造逻辑的原子性，
__new__+__init__组合不是临界区 - 装饰器或模块级单例（如
import singleton_module）虽简单，但不支持带参数的初始化，也不易测试和重置 - 用
threading.Lock手动加锁是最可控的方式，但锁的粒度和位置很关键
用 threading.Lock 包裹实例创建全过程
必须把整个“检查 + 创建 + 赋值”三步包进同一个锁里，且锁对象本身不能依赖实例（否则死锁）。推荐在类定义时就声明为类属性：
import threading
<p>class ThreadSafeSingleton:
_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
- 双重检查（Double-Checked Locking）是关键：外层
if减少锁竞争，内层if防止重复创建 -
__init__不做耗时操作；如果必须传参，建议把参数存在类变量里，在__new__中读取，或改用工厂方法 - 不要在
__new__里调用super().__init__()—— Python 自动处理，手动调用会导致__init__执行两次
用 threading.local() 实现“伪单例”？别混淆概念
threading.local() 创建的是**线程本地存储**，每个线程拿到的是独立副本，根本不是单例。它解决的是“每线程一个实例”，而非“全局唯一实例”。误用会导致：
- 你以为共享的状态其实各玩各的，比如缓存、连接池失效
- 调试时发现数据不一致，却查不到并发修改痕迹
- 名字带“local”就以为安全，但和单例目标完全相反
除非你明确需要 per-thread instance（例如 Flask 的 g 对象），否则不要把它当单例方案。
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
带参数初始化的线程安全单例怎么写
标准单例不允许重复初始化，所以首次调用必须传全所有必要参数；后续调用忽略参数。常见错误是把参数塞进 __init__ 导致每次调用都覆盖状态。
正确做法：用类变量暂存初始化参数，只在真正创建实例时读取一次：
class ConfigurableSingleton:
_instance = None
_lock = threading.Lock()
_init_args = None
_init_kwargs = None
<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._init_args = args
cls._init_kwargs = kwargs
cls._instance = super().__new__(cls)
return cls._instance
def __init__(self):
if not hasattr(self, '_configured'):
args = self.__class__._init_args
kwargs = self.__class__._init_kwargs
self.setup(*args, **kwargs)
self._configured = True
注意：_init_args 和 _init_kwargs 是类变量，必须在 __new__ 中赋值，不能放到 __init__ 里——后者可能被多次触发。
真正复杂的地方在于：你要想清楚“参数是否允许变化”。如果业务要求运行时可重配置，那就不是单例，该用依赖注入或配置中心。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
