Python 单例模式的几种实现方式

 更新时间:2026年05月01日 10:45:41   作者:huzhongqiang  
本文分享Python单例模式四种实现方式(装饰器、new、函数、lru_cache),文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

前言

最近在整理代码时,重新审视了项目中用到的单例模式实现。发现自己对单例模式的理解经历了一个有趣的循环:从懵懂使用,到追求各种"巧妙"实现,再到回归朴素。

今天想分享几种 Python 实现单例模式的方式,并谈谈我多年编程的一个感悟:朴素的就是最好的

一、单例模式简介

单例模式(Singleton Pattern)是一种设计模式,确保一个类只有一个实例,并提供一个全局访问点。

🎯 适用场景

场景说明
数据库连接全局共享一个连接池
日志记录器避免重复打开文件
配置管理器全局只读一份配置
缓存实例全局共享缓存

二、四种实现方式

方式一:类装饰器

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

特点:装饰器语法优雅,使用时一目了然。

方式二:__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

特点:最直接的方式,但 _instance 作为类变量暴露在外。我之前的博文 Playwright理解与封装就是使用这种方式,感觉不太好,准备重构一下,那个类根本不需要单例模式,如果使用者觉得有必要,可以显式自行单例化即可。

方式三:函数

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")

特点:需要显式调用 singleton(),语义明确但稍显繁琐。

方式四:functools.lru_cache

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

特点:Python 内置,简单直接,还能享受缓存的好处。

三、优缺点对比

实现方式优点缺点推荐指数
类装饰器语法优雅、语义清晰、易于理解对于非必要实现单例的类,对使用者会造成困扰⭐⭐⭐⭐
new 方法最直观、最简单实例变量暴露、可复用性不好⭐⭐
单例函数显式调用、可控性强,使用者清楚知道正在做什么每次都要调用、不够直观⭐⭐⭐
lru_cache内置、无需额外代码语义上不是单例、更像缓存,但是胜在简单⭐⭐⭐⭐

四、我的建议

💡 优先使用显式单例

相比把类变成单例,显式获取单例的写法更加清晰:

# ✅ 推荐:显式获取单例
_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
class Database:
    ...

为什么?

  1. 透明性:使用者能清楚看到这个类是全局共享的
  2. 可控性:可以灵活控制何时创建、如何创建
  3. 易测试:mock 和替换更容易
  4. 少歧义:不会让使用者误以为每次 new 都是新实例

五、多年编程感悟

朴素的就是最好的。所有当时自鸣得意的所谓编程技巧,最后都会被证明要用更多的代价来理解和维护它。

🎯 几个教训

当年觉得"巧妙"后来发现的问题
复杂的继承链调试时一头雾水
动态修改类属性难以追踪状态变化
魔法装饰器新人看不懂
元编程炫技给自己挖坑

🌿 回归朴素

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

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

简单、直白、不需要解释。这才是好的代码。

六、总结

📌 要点回顾

  1. 装饰器方式是最推荐的类单例实现(针对必须实现单例的类)
  2. 显式获取单例比把类变成单例更好
  3. lru_cache 是最简单的单例缓存方案
  4. 朴素思维:能用简单方式解决的问题,不要过度设计

到此这篇关于Python 单例模式的几种实现方式的文章就介绍到这了,更多相关Python 单例模式内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • python实现将两个文件夹合并至另一个文件夹(制作数据集)

    python实现将两个文件夹合并至另一个文件夹(制作数据集)

    这篇文章主要介绍了python实现将两个文件夹合并至另一个文件夹(制作数据集),具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-04-04
  • 在Python的Django框架中用流响应生成CSV文件的教程

    在Python的Django框架中用流响应生成CSV文件的教程

    这篇文章主要介绍了在Python的Django框架中用流响应生成CSV文件的教程,作者特别讲到了防止CSV文件中的中文避免出现乱码等问题,需要的朋友可以参考下
    2015-05-05
  • 解决pytorch 保存模型遇到的问题

    解决pytorch 保存模型遇到的问题

    这篇文章主要介绍了解决pytorch 保存模型遇到的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-03-03
  • Python反爬机制-验证码功能的具体实现过程

    Python反爬机制-验证码功能的具体实现过程

    Tesseract-OCR是一个免费、开源的OCR引擎,通过该引擎可以识别图片中的验证码,这篇文章主要介绍了Python反爬机制-验证码的示例代码,需要的朋友可以参考下
    2022-02-02
  • Python如何通过ARIMA模型进行时间序列分析预测

    Python如何通过ARIMA模型进行时间序列分析预测

    这篇文章主要介绍了Python如何通过ARIMA模型进行时间序列分析预测问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-02-02
  • Python 实现Excel XLS和XLSX格式相互转换问题

    Python 实现Excel XLS和XLSX格式相互转换问题

    本文介绍如何使用Python库Spire.XLS for Python实现Excel文件的XLS和XLSX格式转换,提供了详细的安装指南和转换步骤,帮助用户在不同版本的Excel文件格式之间灵活转换,同时支持将Excel文件转换为PDF、图片、HTML等格式
    2024-10-10
  • python flask基于cookie和session来实现会话控制的实战代码

    python flask基于cookie和session来实现会话控制的实战代码

    所谓的会话(session),就是客户端浏览器和服务端网站之间一次完整的交互过程,本文介绍falsk通过cookie和session来控制http会话的全部解析,通常我们可以用cookie和session来保持用户登录等,感兴趣的朋友一起看看吧
    2024-03-03
  • Python如何绘制概率分布直方图浅析

    Python如何绘制概率分布直方图浅析

    项目中在前期经常要看下数据的分布情况,这对于探究数据规律非常有用,概率分布表示样本数据的模样,使用Python绘制频率分布直方图非常简洁,因为用的频次非常高,这篇文章主要给大家介绍了关于Python如何绘制概率分布直方图的相关资料,需要的朋友可以参考下
    2021-12-12
  • python导入pandas具体步骤方法

    python导入pandas具体步骤方法

    在本篇文章中小编给大家分享了关于python导入pandas的相关知识点内容,有兴趣的朋友们参考学习下。
    2019-06-06
  • python新手学习可变和不可变对象

    python新手学习可变和不可变对象

    在本篇文章里小编给大家分享了是一篇关于python可变对象和不可变对象的基础知识点内容,有需要的朋友们可以参考下。
    2020-06-06

最新评论