第5章单例模式实现（三）

课程目录第5章单例模式实现（三）

5、单例模式实现（三）：基于元类（Metaclass）的单例实现、模块级别的单例

好，咱们接着聊单例模式。前面我们讲了装饰器实现和基于类方法的实现，这两种方式各有各的适用场景。但说实话，在Python里还有一种更「底层」、更「优雅」的实现方式——那就是用元类（Metaclass）。

我个人习惯把元类理解成「类的类」。你想想看，普通类是用来创建对象的，那元类就是用来创建类的。既然我们能控制对象的创建过程，那自然也能控制类的创建过程。单例模式的核心不就是控制实例化次数吗？用元类来做这件事，本质上是在类被创建时就埋下了一个「只生成一个实例」的钩子。

5.1 元类实现单例的核心思路

元类实现单例，说白了就是重写元类的 __call__ 方法。为什么是 __call__？因为当你写 MyClass() 的时候，Python 实际上调用了元类的 __call__ 方法。这个方法内部会调用类的 __new__ 和 __init__。我们只要在 __call__ 里做文章，就能控制实例的生成。

来看代码：

class SingletonMeta(type):
    _instances = {}

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

class Database(metaclass=SingletonMeta):
    def __init__(self):
        self.connection = None
        print("数据库连接已创建")

# 测试
db1 = Database()
db2 = Database()
print(db1 is db2)  # True

这段代码里，SingletonMeta 继承自 type，它就是一个元类。我们用 _instances 这个字典来缓存已经创建过的实例。每次调用 Database() 时，都会先检查这个类有没有实例存在，有就直接返回，没有才创建。

关键点：元类实现的单例，对所有的子类也是有效的。如果你继承 Database，子类也会自动变成单例。这一点和装饰器实现不同，装饰器通常只作用于被装饰的类本身。

5.2 元类实现的优缺点

我在项目中遇到过一个问题：用装饰器实现单例时，如果类本身有复杂的继承关系，装饰器可能会破坏 isinstance 检查。但元类实现就不会有这个问题，因为元类是在类定义层面做手脚，实例的类型仍然是正确的。

对比维度	元类实现	装饰器实现
类型安全	✅ 保持原始类型	⚠️ 可能改变类型
继承支持	✅ 子类自动单例	❌ 需要额外处理
代码复杂度	中等	较低
可读性	较低（需要理解元类）	较高

嗯，这里要注意：元类实现虽然强大，但并不是所有场景都适合。如果你的团队成员对元类不熟悉，我建议还是用装饰器或者模块级别的单例，毕竟代码是给人读的。

5.3 模块级别的单例

说到模块级别的单例，这可能是Python里最简单、最Pythonic的单例实现方式了。Python的模块本身就是单例的——不管你 import 多少次，模块只会被加载一次。利用这个特性，我们只需要在模块里创建一个实例，然后到处引用它就行了。

说白了就是：

# database.py
class DatabaseConnection:
    def __init__(self):
        self.host = "localhost"
        self.port = 3306
        self._connected = False

    def connect(self):
        if not self._connected:
            print(f"连接到 {self.host}:{self.port}")
            self._connected = True
        return self

# 直接创建实例
db = DatabaseConnection()

然后在其他地方使用：

# app.py
from database import db

def get_data():
    db.connect()
    # 使用数据库...

# another_module.py
from database import db  # 同一个实例

def save_data():
    db.connect()
    # 保存数据...

你看，不需要任何元类、装饰器，甚至不需要写单例类。Python的模块机制天然保证了 db 这个对象在整个进程里只有一个。我曾经在一个微服务项目里就用这种方式管理Redis连接池，简单到团队成员看一遍代码就懂了。

小技巧：模块级别的单例适合那些「全局只需要一个」的资源，比如数据库连接、日志记录器、配置管理器。但要注意，如果你需要延迟初始化（比如连接在第一次使用时才创建），那还是得用类来实现。

5.4 三种实现方式的对比

好了，我们讲了三种单例实现方式：装饰器、元类、模块级别。你可能会问，到底该用哪一种？我的建议是：

模块级别：最简单，适合大多数场景。如果你的单例不需要继承、不需要延迟初始化，首选这个。
装饰器：适合需要保持类定义清晰，但又想控制实例化的场景。我在写工具库时经常用。
元类：适合框架级别的代码，或者需要确保所有子类都是单例的场景。但别滥用，元类会让代码变得难以理解。

我曾经在一个项目中看到有人用元类实现了单例，结果新来的同事花了整整一天才搞明白代码在干什么。嗯，有时候「简单」比「高级」更重要。

5.5 知识体系图

下面这张图总结了单例模式三种实现方式的核心逻辑和适用场景：

避坑指南：我曾经在一个多线程项目里用模块级别的单例管理数据库连接，结果在高并发下出现了连接竞争问题。后来加了个线程锁才解决。所以记住：单例只保证实例唯一，不保证线程安全。如果你的单例对象会被多个线程同时访问，记得加锁。

好了，单例模式的三种实现方式就讲到这里。每种方式都有自己的用武之地，关键是根据实际场景选择最合适的。我个人最常用的是模块级别，简单可靠；但如果需要更精细的控制，元类实现也是个不错的选择。

公众号:蓝海资料掘金营，微信deep3321

📚 课程目录

5、单例模式实现（三）：基于元类（Metaclass）的单例实现、模块级别的单例

5.1 元类实现单例的核心思路

5.2 元类实现的优缺点

5.3 模块级别的单例

5.4 三种实现方式的对比

5.5 知识体系图