仅靠__new__中一次if判断无法保证线程安全，必须用threading.Lock做双重检查或改用模块级实例；因多线程下多个线程可能同时通过首次判空而重复创建实例，造成竞态条件。
直接结论：仅靠 __new__ 中一次 if 判断无法保证线程安全，必须用 threading.Lock 做双重检查（Double-Checked Locking）或改用模块级实例。
为什么单次 if 判断在多线程下会失效
多个线程几乎同时执行到 if cls._instance is None 时，都可能为 True，于是全部进入创建逻辑——结果生成多个实例。这不是概率低的问题，而是确定性竞态条件。
常见错误现象：
- 日志里看到同一类被初始化了 2–3 次
- 数据库连接池重复建立连接，报
ConnectionRefusedError或连接数超限 - 配置对象的
__init__被执行多次，环境变量读取/文件加载重复触发
用 threading.Lock 实现双重检查锁定
这是类内实现中最稳妥的写法，兼顾性能与安全性。核心是「先无锁快查 → 再加锁细查 → 最后创建」。
立即学习“Python免费学习笔记（深入）”；
实操要点：
- 锁对象必须是类属性（
_lock = threading.Lock()），不能在方法内新建 - 第一次
if在锁外，避免每次调用都抢锁，影响高并发性能 - 第二次
if必须在with cls._lock:块内，否则仍可能漏掉竞态 - 不要用
hasattr(cls, '_instance')替代cls._instance is None，前者在多线程下有隐含状态窗口
示例代码片段：
import threading
<p>class Logger:
_instance = None
_lock = threading.Lock()</p><pre class='brush:python;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</pre>模块级实例才是最简单且真正线程安全的解法
Python 解释器保证模块只导入一次，且模块顶层代码执行是原子的——这意味着 instance = MyClass() 这行在首次 import 时就完成，后续所有线程拿到的都是同一个对象。
适用场景：
- 初始化逻辑不依赖运行时参数（如只读环境变量、配置文件）
- 不需要在单元测试中替换/重置实例（否则用
importlib.reload()配合测试隔离） - 希望零配置、零锁、零元编程，直接靠语言机制兜底
典型结构：
# config.py
import os
<p>class _Config:
def <strong>init</strong>(self):
self.debug = os.getenv("DEBUG") == "1"
self.db_url = os.getenv("DB_URL", "sqlite:///app.db")</p><h1>✅ 模块级唯一实例，天然线程安全</h1><p>Config = _Config()其他模块直接 from config import Config 即可，无需任何锁或判断。
容易被忽略的初始化陷阱
很多人把耗时操作（比如数据库连接、大文件加载）放在 __init__ 里，却没意识到：即使单例对象只有一个，它的 __init__ 也可能被多个线程并发调用——因为 __new__ 返回已有实例后，Python 仍会调用 __init__。
正确做法：
- 把初始化逻辑从
__init__挪到类方法中（如init_once()），并用锁保护 - 或者更推荐：在模块顶层直接执行初始化（如上文
config.py示例），确保只跑一次 - 若必须懒加载，需在实例属性上加锁控制，不能只靠单例构造锁
一句话收尾：线程安全单例的关键不在“单”，而在“初始化过程不可重入”——模块级实例靠解释器保障，类内实现必须靠锁+双重检查，少一个环节就破防。
