Python单例模式实现详解：从全局变量到元类与装饰器

慢慢来

发布时间：2026-10-13| 6人浏览过

原创

本文深入探讨Python中实现单例模式的多种方案，涵盖全局变量、元类（metaclass）、重写__new__方法及装饰器四种经典实现。详细解析各方式的核心原理与代码逻辑，对比其适用场景与优缺点，帮助开发者根据实际需求选择最优的单例实现策略，确保全局对象唯一性。

在Python开发中，如何实现单例模式是一个高频出现的经典面试题。本文将系统梳理Python中实现单例模式的多种具体方式，并深入剖析其背后的运行原理。

什么是单例模式

根据维基百科的定义：

单例模式（Singleton Pattern），亦称单子模式，属于常用的软件设计模式之一。该模式的核心要求是：一个类的实例必须保证在整个系统中仅存在唯一的一个对象。在许多系统架构中，全局仅需一个实例即可满足需求，这有助于协调系统整体行为。例如，在服务器程序中，配置信息通常存储于文件中，由一个单例对象统一读取，其他服务进程通过该单例对象获取配置。这种方式有效简化了复杂环境下的配置管理流程。

在日常编程实践中，单例模式最典型的应用场景是配置类。以下是一个具体示例：

from config import config
print(config.SQLALCHEMY_DB_URI)

我们的目标是确保 config 对象在全局范围内保持唯一性。基于此需求，实现单例模式最直观的方法便是利用全局变量。

实现单例模式的具体方式

全局变量法

我们可以在一个独立的模块中定义配置类：

# config.py
class Config:
  def __init__(self, SQLALCHEMY_DB_URI):
    self.SQLALCHEMY_DB_URI = SQLALCHEMY_DB_URI
config = Config("mysql://xxx")

当然，上述代码仅为演示。在实际工程中，直接编写 __init__ 方法往往较为繁琐。我们可以考虑利用Python 3.7引入的 dataclass 特性来简化代码：

# config.py
from dataclasses import dataclass
@dataclass
class Config:
    SQLALCHEMY_DB_URI = SQLALCHEMY_DB_URI
config = Config(SQLALCHEMY_DB_URI ="mysql://")

通过全局变量方式，所有需要引用配置的地方只需使用 from config import config 进行导入，即可实现全局唯一性的目标。

使用元类（metaclass）

class Singleton(type):
  _instances = {}
  def __call__(cls, *args, **kwargs):
    if cls not in cls._instances:
      cls._instances[cls] = super(Singleton, cls).__call__(*args, **kwargs)
    return cls._instances[cls]
class Config(metaclass=Singleton):
  def __init__(self, SQLALCHEMY_DB_URI):
    self.SQLALCHEMY_DB_URI = SQLALCHEMY_DB_URI

元类是“类的类”。在Python中，instance是类的实例，class是元类的实例。因此，当 Config 被实例化时，会触发 Singleton.__call__ 方法的执行。这意味着，无论何处调用 Config()，最终都会返回同一个对象实例。

重写 __new__ 方法

class Singleton(object):
  _instance = None
  def __new__(class_, *args, **kwargs):
    if not isinstance(class_._instance, class_):
      class_._instance = object.__new__(class_, *args, **kwargs)
    return class_._instance
class Config(Singleton, BaseClass):
  pass

在Python中，类实例化的过程分为两步：首先执行 Config.__new__ 生成实例，随后执行实例.__init__ 进行初始化。因此，通过重写 __new__ 方法，可以确保所有对 Config() 的调用都返回同一个对象。

使用装饰器

def singleton(class_):
  class class_w(class_):
    _instance = None
    def __new__(class_, *args, **kwargs):
      if class_w._instance is None:
        class_w._instance = super(class_w, class_).__new__(class_, *args, **kwargs)
        class_w._instance._sealed = False
      return class_w._instance
    def __init__(self, *args, **kwargs):
      if self._sealed:
        return
      super(class_w, self).__init__(*args, **kwargs)
      self._sealed = True
  class_w.__name__ = class_.__name__
  return class_w
@singleton
class Config(BaseClass):
  pass

利用装饰器同样可以实现单例效果。其原理是利用闭包存储实例：在每次调用 Config() 之前，检查该实例是否存在；若已初始化，则直接返回；否则调用 Config() 进行初始化并存储该实例。

总结

纵观上述四种实现单例的方式，可以发现它们具有一个共同的核心机制：在真正调用 Config() 之前进行拦截操作，以确保返回的对象始终为同一个。具体表现为：