单例模式（Singleton）

单例模式是最常被提及、也最容易被误用的设计模式之一。

在 Python 中，由于语言特性特殊，单例模式既简单 ，也容易踩坑。

本篇我们重点解决三个问题：

1. 单例模式到底解决什么问题
2. Python 中有哪些实现方式
3. 哪些场景真的适合用单例

---

一、什么是单例模式

单例模式（Singleton） 的定义很简单：

保证一个类在系统中只有一个实例，并提供全局访问点。

核心目标只有两个：

• 控制实例数量：只能有一个
• 提供统一访问入口

---

二、为什么需要单例模式

在实际项目中，以下对象往往只需要一个实例：

• 配置中心
• 日志对象
• 数据库连接池
• 缓存管理器
• 全局状态管理器

如果这些对象被反复创建，可能带来：

• 资源浪费
• 状态不一致
• 隐蔽的逻辑 Bug

---

三、最"Python 风格"的单例：模块即单例

在 Python 中，模块天然是单例的。

# config.py
class Config:
    DEBUG = True

# main.py
from config import Config

解释：

• 模块只会被加载一次
• 多次 import 返回的是同一个模块对象

✅ 推荐指数：★★★★★

如果能用模块解决，不要写复杂单例代码。

---

四、基于 __new__ 的经典单例实现

当你必须使用类时，最常见的是重写 __new__。

class Singleton:
    _instance = None

    def __new__(cls, *args, **kwargs):
        if cls._instance is None:
            cls._instance = super().__new__(cls)
        return cls._instance

测试：

a = Singleton()
b = Singleton()
print(a is b)  # True

特点：

• 控制实例创建过程
• 逻辑清晰，易理解
• 是讲解单例原理的最佳示例

---

五、线程安全的单例（加锁版）

在多线程环境中，上面的实现并不安全。

import threading

class Singleton:
    _instance = None
    _lock = threading.Lock()

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

适用场景：

• 多线程程序
• Web 服务
• 后台任务系统

---

六、装饰器方式实现单例

利用 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 Logger:
    pass

特点：

• 写法简洁
• 不修改类内部代码
• 对初学者可读性稍弱

---

七、元类实现单例（了解即可）

元类控制的是类的创建行为：

class SingletonMeta(type):
    _instances = {}

    def __call__(cls, *args, **kwargs):
        if cls not in cls._instances:
            cls._instances[cls] = super().__call__(*args, **kwargs)
        return cls._instances[cls]

class Config(metaclass=SingletonMeta):
    pass

适合：

• 框架级代码
• 需要统一约束大量类的场景

❗ 日常业务代码中不推荐滥用。

---

八、单例模式的常见误区

1. 把单例当全局变量用

• 滥用会导致隐藏依赖
• 增加测试难度
• 破坏模块解耦

---

2. 所有"全局对象"都做成单例

判断标准只有一个：

系统中是否逻辑上只允许存在一个实例？

---

3. 忽略生命周期管理

单例≠永远存在

尤其在长生命周期服务中，要考虑：

• 初始化时机
• 资源释放
• 重启行为

---

九、什么时候该用单例，什么时候不该用

适合使用：

• 配置管理
• 日志
• 连接池
• 缓存控制器

不适合使用：

• 业务对象（订单、用户、商品）
• 状态频繁变化的对象
• 需要大量 Mock 测试的组件

---

十、总结

单例模式在 Python 中：

• 实现方式多
• 模块方式最优先
• 能不用就不用，用就用清楚

理解单例的关键不在"怎么写"，而在于：

你是否真的需要系统中只有一个实例。