Python 中的单例模式（Singleton Pattern）
单例模式是一种创建型设计模式，其核心目的是：确保一个类全局只有一个实例，并提供一个全局访问点来获取该实例。
常见应用场景：
- 数据库连接池
- 日志器（Logger）
- 配置管理器（Config Manager）
- 线程池
- 缓存对象
单例模式的优点
- 节省资源（只创建一次）
- 全局统一访问
- 控制实例数量
缺点
- 难以单元测试（全局状态）
- 可能隐藏依赖关系
- 在多线程环境下需小心实现
Python 中实现单例模式的几种常见方式
Python 是动态语言，实现单例非常灵活。下面从简单到推荐依次介绍。
1. 使用模块级变量（最 Pythonic，最推荐！）
Python 模块本身就是天然的单例，所有导入模块的代码共享同一个实例。
# singleton.pyclass_Singleton:def__init__(self):print("Singleton created")defdo_something(self):print("Doing something...")instance=_Singleton()# 模块级实例，只创建一次# 在其他文件中使用# from singleton import instancefromsingletonimportinstanceprint(instance)# 同一个对象instance.do_something()优点：简单、无需额外代码、线程安全、天生单例
这是大多数 Python 项目中实际使用的“单例”方式。
2. 使用__new__方法重写（经典方式）
classSingleton:_instance=Nonedef__new__(cls,*args,**kwargs):ifcls._instanceisNone:cls._instance=super().__new__(cls)returncls._instancedef__init__(self):# 注意：__init__ 可能会被调用多次！# 如果需要初始化逻辑，要防止重复执行ifnothasattr(self,'_initialized'):print("Initializing singleton...")self._initialized=True# 测试s1=Singleton()s2=Singleton()print(s1iss2)# Trueprint(id(s1),id(s2))# 相同地址注意：__init__会被调用多次（每次实例化时），所以初始化逻辑要加保护。
3. 使用装饰器实现
defsingleton(cls):instances={}defget_instance(*args,**kwargs):ifclsnotininstances:instances[cls]=cls(*args,**kwargs)returninstances[cls]returnget_instance@singletonclassMyClass:def__init__(self,value):self.value=value# 使用a=MyClass(10)b=MyClass(20)print(aisb)# Trueprint(a.value)# 10（第一次传入的值生效，后续忽略）4. 使用元类（Metaclass）实现（高级方式）
classSingletonMeta(type):_instances={}def__call__(cls,*args,**kwargs):ifclsnotincls._instances:instance=super().__call__(*args,**kwargs)cls._instances[cls]=instancereturncls._instances[cls]classDatabaseConnection(metaclass=SingletonMeta):def__init__(self):print("Connecting to database...")# 使用db1=DatabaseConnection()db2=DatabaseConnection()print(db1isdb2)# True5. 线程安全的单例（使用锁）
如果在多线程环境中使用__new__方式，建议加锁避免竞争：
importthreadingclassThreadSafeSingleton:_instance=None_lock=threading.Lock()def__new__(cls,*args,**kwargs):ifcls._instanceisNone:withcls._lock:# 双重检查（Double-Checked Locking）ifcls._instanceisNone:cls._instance=super().__new__(cls)returncls._instance推荐总结
| 方式 | 推荐度 | 线程安全 | 简洁性 | 说明 |
|---|---|---|---|---|
| 模块导入 | ★★★★★ | 是 | 最高 | 最 Pythonic，强烈推荐 |
__new__重写 | ★★★★ | 需加锁 | 高 | 经典方式 |
| 装饰器 | ★★★ | 是 | 中 | 灵活但参数会被忽略 |
| 元类 | ★★ | 是 | 低 | 强大但复杂 |
| threading.Lock | ★★★ | 是 | 中 | 多线程必备 |
实际建议
- 99% 的场景下，使用模块级单例就够了，不要过度设计。
- 如果你真的需要一个“类”的单例行为，使用
__new__或元类。 - 避免在单例中持有可变全局状态（容易导致 bug）。
如果你想看单例在实际项目中的应用（如日志器、配置中心），或者结合其他模式（如工厂+单例），可以告诉我！
