在 Python 中实现“类的全局唯一实例”，即**单例模式（Singleton Pattern）**，是指一个类在整个 Python 进程生命周期中**最多只能有一个实例**，且所有对该类的构造请求都返回同一个对象。这是常见的设计模式，常用于配置管理器、日志记录器、数据库连接池、全局状态管理等场景。 --- ### ✅ 实现方式（推荐 4 种，按推荐度排序） #### ✅ 方法 1：使用 `__new__` + 类变量（最 Pythonic、线程安全需额外处理） ```python class Singleton: _instance = None def __new__(cls): if cls._instance is None: cls._instance = super().__new__(cls) # 可在此处初始化一次性的属性（如：cls._instance._initialized = True） return cls._instance def __init__(self): # 注意：__init__ 每次调用构造函数都会执行！ # 若只想初始化一次，请加保护逻辑（见下方增强版） pass # ✅ 使用示例 s1 = Singleton() s2 = Singleton() print(s1 is s2) # True ``` ⚠️ **问题**：`__init__` 会在每次 `Singleton()` 调用时执行（即使返回的是已有实例），可能导致重复初始化。 ✅ **增强版（确保 `__init__` 仅执行一次）**： ```python class Singleton: _instance = None _initialized = False def __new__(cls): if cls._instance is None: cls._instance = super().__new__(cls) return cls._instance def __init__(self): if not self._initialized: # ✅ 仅首次初始化 self.data = [] self.config = {"debug": True} self._initialized = True ``` --- #### ✅ 方法 2：使用装饰器（解耦、可复用、支持任意类） ```python def singleton(cls): instances = {} def get_instance(*args, **kwargs): if cls not in instances: instances[cls] = cls(*args, **kwargs) return instances[cls] return get_instance @singleton class DatabaseConnection: def __init__(self): print("Connecting to DB...") # 仅打印一次 ``` > ✅ 优点：不侵入类定义；可轻松应用到多个类；支持带参构造（但注意：相同参数才复用，不同参数会新建——若需严格单例，应禁止传参或忽略参数）。 --- #### ✅ 方法 3：使用模块级单例（最简单、最 Pythonic、天然线程安全） Python 模块本身就是单例（import 一次，全局唯一）： ```python # config.py class Config: def __init__(self): self.debug = True self.host = "localhost" config = Config() # 模块加载时创建唯一实例 ``` 使用： ```python from config import config print(config.debug) # True ``` ✅ 优势：无竞态、无 `__new__` 复杂性、符合 Python 哲学（“简单优于复杂”）。 ❌ 缺点：无法延迟初始化（模块导入即创建）；不能通过类名动态控制。 --- #### ✅ 方法 4：使用 `threading.Lock` 的线程安全 `__new__`（多线程环境必备） ```python import threading class ThreadSafeSingleton: _instance = None _lock = threading.Lock() def __new__(cls): if cls._instance is None: with cls._lock: if cls._instance is None: # double-checked locking cls._instance = super().__new__(cls) return cls._instance def __init__(self): if not hasattr(self, '_initialized'): self.counter = 0 self._initialized = True ``` > ✅ 适用于多线程/多协程（如 asyncio 中多个 task 并发调用）场景。注意：`asyncio` 中若用 `await` 需配合 `asyncio.Lock`。 --- ### ❗重要说明与常见误区 | 问题 | 解释 | |------|------| | **`__init__` 为什么会被多次调用？** | 因为 `__new__` 返回已有实例后，Python 仍会调用 `__init__`；必须手动加 `_initialized` 标志避免重复初始化。 | | **`@staticmethod` 或 `@classmethod` 能实现单例吗？** | 不能。它们只是方法绑定方式，不控制实例创建逻辑。 | | **`isinstance(s1, Singleton)` 是否成立？** | ✅ 是。单例仍是该类的实例，类型检查完全正常。 | | **继承单例类是否仍保持单例？** | ❌ 默认不继承单例行为！子类 `__new__` 会覆盖父类逻辑。需显式继承 `_instance` 机制或重写子类 `__new__`。 | | **单例 vs 全局变量？** | 单例是对象，可封装状态+行为；全局变量只是数据。单例更面向对象、可测试、可继承（谨慎）、可 mock。 | --- ### 🧩 扩展建议（生产环境推荐） - 使用 [**`weakref.WeakValueDictionary`**](https://docs.python.org/3/library/weakref.html#weakref.WeakValueDictionary) 管理单例（避免内存泄漏，尤其在频繁创建/销毁类的测试中）； - 结合 `functools.lru_cache(maxsize=1)` 实现函数式单例（适合无状态工厂）； - 在依赖注入框架（如 `dependency-injector` 或 `Dagger` 风格）中声明 `scope=singleton`。 ---