Python实现单例模式有哪些常用方法

单例模式是设计模式里的基础类型，核心目标是让一个类在整个程序生命周期中只生成一个实例，并且对外提供统一的访问入口，在全局配置管理、日志系统、数据库连接池等场景中有广泛应用。Python作为动态语言，有多种不同的方式可以实现这个模式，每种方式的特点和适用场景也有区别。

什么是单例模式

单例模式属于创建型设计模式，它的核心约束有两个：第一，类的实例化过程被严格控制，只能生成一个实例；第二，这个类需要提供一个全局可访问的方法，让所有需要使用的模块都能获取到这个唯一的实例。如果没有单例模式的约束，多次实例化同一个类可能会带来资源浪费、状态不一致等问题，比如多个数据库连接实例会占用多余的数据库链接资源。

Python实现单例模式的常用方法

1. 重写__new__方法实现

Python中类的实例化过程会先调用__new__方法创建实例对象，再调用__init__方法初始化实例，我们可以通过重写__new__方法控制实例的创建逻辑，判断是否已经存在实例，如果存在就直接返回已有的实例。

class SingletonByNew:
    # 类变量，用来存储唯一的实例
    _instance = None

    def __new__(cls, *args, **kwargs):
        # 如果实例不存在，就调用父类的__new__方法创建实例
        if cls._instance is None:
            cls._instance = super().__new__(cls, *args, **kwargs)
        # 返回存储的唯一实例
        return cls._instance

    def __init__(self, value=None):
        # 避免重复初始化，只有第一次实例化的时候才赋值
        if not hasattr(self, 'value'):
            self.value = value

# 测试代码
s1 = SingletonByNew(10)
s2 = SingletonByNew(20)
print(s1 is s2)  # 输出True，说明两个变量指向同一个实例
print(s1.value)  # 输出10，第二次实例化没有覆盖第一次的初始化值

这种方式的优点是逻辑直观，容易理解，缺点是需要额外处理__init__重复调用的问题，如果每次实例化都传入不同参数，可能会导致初始化逻辑被意外覆盖。

2. 使用装饰器实现

装饰器是Python中非常灵活的特性，我们可以写一个装饰器，让被装饰的类在实例化的时候自动返回唯一的实例，不需要修改类本身的内部逻辑。

def singleton_decorator(cls):
    # 闭包变量，存储类的唯一实例
    _instances = {}

    def get_instance(*args, **kwargs):
        # 如果类还没有实例，就创建并存储
        if cls not in _instances:
            _instances[cls] = cls(*args, **kwargs)
        # 返回存储的实例
        return _instances[cls]
    return get_instance

@singleton_decorator
class SingletonByDecorator:
    def __init__(self, value=None):
        self.value = value

# 测试代码
s1 = SingletonByDecorator(10)
s2 = SingletonByDecorator(20)
print(s1 is s2)  # 输出True
print(s1.value)  # 输出10

这种方式的优点是不侵入类的定义，可复用性强，同一个装饰器可以给多个类添加单例特性，缺点是被装饰的类不再是原来的类类型，可能会影响类型判断相关的逻辑。

3. 利用Python模块特性实现

Python的模块在程序中只会被导入一次，模块级别的变量在整个程序中是唯一的，我们可以直接利用这个特性实现单例模式，不需要额外的复杂逻辑。

首先创建一个单独的模块文件singleton_module.py，内容如下：

# singleton_module.py内容
class _SingletonClass:
    def __init__(self, value=None):
        self.value = value

# 模块加载时创建唯一实例
singleton_instance = _SingletonClass(10)

在其他文件中导入这个实例使用：

# 导入模块中的唯一实例
from singleton_module import singleton_instance

# 测试代码
a = singleton_instance
b = singleton_instance
print(a is b)  # 输出True
print(a.value)  # 输出10

这种方式的优点是实现最简单，不需要写额外的控制逻辑，性能也最好，缺点是单例的定义分散在模块中，不够灵活，如果需要动态控制实例的生成逻辑就不太适合。

4. 使用元类实现

元类是创建类的类，我们可以通过自定义元类，控制类的创建和实例化过程，在元类层面实现单例逻辑，所有使用该元类的类都会自动具备单例特性。

class SingletonMeta(type):
    # 元类的属性，存储所有单例类的实例
    _instances = {}

    def __call__(cls, *args, **kwargs):
        # 如果类还没有实例，就调用类的__new__和__init__创建实例
        if cls not in cls._instances:
            cls._instances[cls] = super().__call__(*args, **kwargs)
        # 返回存储的实例
        return cls._instances[cls]

class SingletonByMeta(metaclass=SingletonMeta):
    def __init__(self, value=None):
        self.value = value

# 测试代码
s1 = SingletonByMeta(10)
s2 = SingletonByMeta(20)
print(s1 is s2)  # 输出True
print(s1.value)  # 输出10

这种方式的优点是灵活性高，可以在元类中统一控制所有单例类的行为，适合需要给多个类添加统一单例逻辑的场景，缺点是元类的概念相对复杂，理解成本较高。

不同实现方式的对比

我们可以通过下面的表格对比几种实现方式的特点：

注意事项

在使用单例模式的时候需要注意几个问题：第一，单例模式的全局实例可能会导致代码耦合度升高，不利于单元测试，测试的时候可能需要额外的逻辑重置单例状态；第二，多线程场景下，上面的部分实现方式可能会存在线程安全问题，比如多个线程同时判断实例不存在，就会创建多个实例，需要额外添加线程锁保证安全；第三，不要过度使用单例模式，只有确实需要全局唯一实例的场景才使用，否则会让代码的扩展性变差。

Python单例模式设计模式__new__方法装饰器修改时间：2026-06-15 14:30:45