Python 单例模式
2026/4/11 8:48:28 网站建设 项目流程

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)# True
5. 线程安全的单例(使用锁)

如果在多线程环境中使用__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)。

如果你想看单例在实际项目中的应用(如日志器、配置中心),或者结合其他模式(如工厂+单例),可以告诉我!

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询