Python 单例模式的几种实现方式与最佳实践

单例模式的核心目标

单例模式旨在确保一个类在整个应用程序生命周期中仅存在一个实例，并提供一个全局访问点。这种设计模式常用于需要共享状态或资源的场景，例如数据库连接池、日志记录器、配置管理器以及缓存实例等。

Python 中的四种实现方式

在 Python 中，实现单例模式有多种途径，每种方式在语法优雅度、使用便捷性和语义清晰度上各有不同。

1. 类装饰器

利用闭包保存唯一实例是类装饰器的核心逻辑。这种方式语法相对优雅，通过装饰器将类包装，使得后续实例化操作返回同一个对象。

def singleton(cls):
    """单例装饰器：闭包保存唯一实例"""
    _instance = None

    def wrapper(*args, **kwargs):
        nonlocal _instance
        if _instance is None:
            _instance = cls(*args, **kwargs)
        return _instance

    return wrapper


@singleton
class DBConnect:
    def __init__(self, host):
        self.host = host
        print("数据库连接初始化")


# 使用
obj1 = DBConnect("127.0.0.1")
obj2 = DBConnect("192.168.1.1")  # 不会重新初始化

print(obj1 is obj2)  # True
print(obj1.host)     # 127.0.0.1

2. __new__ 方法

通过重写类的 __new__ 方法，可以在实例创建阶段控制返回的对象。该方法将实例存储为类变量，确保每次调用构造函数时返回相同的实例。

class MySingleton:
    """单例类：通过 __new__ 控制实例创建"""
    _instance = None

    def __new__(cls):
        if cls._instance is None:
            cls._instance = super().__new__(cls)
        return cls._instance


# 使用
obj1 = MySingleton()
obj2 = MySingleton()
print(obj1 is obj2)  # True

3. 工厂函数

不使用类装饰器或魔法方法，而是通过一个独立的函数来管理实例。这种方式需要显式调用工厂函数来获取单例，语义上更加明确，但使用频率稍低。

from typing import Type, TypeVar

T = TypeVar('T')

def singleton(cls: Type[T], *args, **kwargs) -> T:
    """单例工厂函数"""
    if not hasattr(cls, '_instance'):
        cls._instance = cls(*args, **kwargs)
    return cls._instance


# 使用
class TargetClass:
    def __init__(self, config):
        self.config = config

obj = singleton(TargetClass, config="value")

4. functools.lru_cache

利用 Python 内置的 functools.lru_cache 装饰器，通过设置 maxsize=1 来实现单例效果。这种方式利用了缓存机制，语义上更接近于缓存而非传统的单例模式。

from functools import lru_cache

@lru_cache(maxsize=1)
def get_instance():
    return MyClass(arg1="value")


# 使用
obj1 = get_instance()
obj2 = get_instance()
print(obj1 is obj2)  # True

方案优缺点对比

不同的实现方式在推荐程度和潜在缺陷上存在差异：

• 类装饰器：推荐指数四星。优点是语法优雅，缺点是可能造成使用上的困扰，使用者可能误以为每次调用都会创建新实例。
• __new__ 方法：推荐指数两星。缺点是实例变量可能暴露，且对类内部状态管理要求较高。
• 单例函数：推荐指数三星。缺点是每次获取实例时需显式调用，代码略显繁琐。
• lru_cache：推荐指数四星。语义上更像缓存，实现简单，但需注意缓存清理机制。

最佳实践建议

综合考量，建议优先使用显式获取单例的方式。这种方式写法清晰，透明度高，使用者明确知道获取的是全局共享实例，便于测试时的 mock 和替换，且避免了透明单例带来的歧义。

# ✅ 推荐：显式获取单例
_db = None
def get_db():
    global _db
    if _db is None:
        _db = Database()
    return _db

# 或者更简洁地用 lru_cache
@lru_cache
def get_db():
    return Database()

相比之下，将类直接变为单例（如使用 @singleton 装饰器）除非确定此类必须是单例且不会造成使用者误解，否则不推荐。

# ❌ 不推荐：把类变成单例，除非很确定此类必须是单例类，不会造成使用者误解
@singleton
class Database:
    ...

编程感悟

复杂的编程技巧往往会增加理解和维护的代价。复杂的继承链、动态修改类属性以及魔法装饰器，都可能导致调试困难，让新人难以理解代码逻辑。好的代码应当简单、直白，避免过度设计。

# 曾经的我：要用单例模式！
@singleton
class ConfigManager:
    ...

# 现在的我：简单就好
@lru_cache
def get_db():
    return Database()

总结

在 Python 中实现单例模式，类装饰器方式较为推荐，但显式获取单例比将类直接变为单例更好。利用 lru_cache 是实现简单缓存方案的有效手段。核心原则是能用简单方式解决就不进行过度设计，保持代码的可读性和可维护性。

以上就是 Python 单例模式的几种实现方式与最佳实践的详细内容，更多关于 Python 设计模式、单例模式实现技巧的资料请关注本站其它相关文章！