Python单例模式实现详解：从装饰器到线程安全优化

山间有风

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

原创

本文系统梳理Python中单例模式的多种实现方式。首先介绍基于装饰器的简洁写法，随后深入类方法实现，重点剖析多线程环境下可能出现的竞态条件问题。通过引入线程锁及双重检查锁定机制，逐步优化代码，最终给出高效且线程安全的单例实现方案，帮助开发者在实际工程中正确应用单例模式。

前言

近期回顾过往编写的代码，借此机会对常用技术点进行梳理。单例模式在日常开发中应用广泛，本文旨在整理相关实践。

此处汇总此前使用过的几种不同单例实现方式。

什么是单例？

单例模式属于对象创建型模式。其核心定义是确保一个类仅有一个实例，并提供全局访问点。该类需自行创建实例，并向整个系统提供该唯一实例。

单例模式的应用场景广泛。以操作系统中的回收站为例，整个系统中回收站只能存在一个实例，所有操作均通过这一唯一实例进行，且由回收站自身提供实例，这正是单例模式的典型应用。

装饰器的方式

这是工作中较为常见且便捷的一种实现方式，具体代码实现如下。

def Singleton(cls):
 _instance = {}

 def _singleton(*args, **kwargs):
  if cls not in _instance:
   _instance[cls] = cls(*args, **kwargs)
  return _instance[cls]

 return _singleton

若需将某个类实现为单例，可采用类似下述方式：

@Singleton
class A(object):

 def __init__(self, x):
  self.x = x

从个人使用体验来看，这种实现方式较为直观且易于维护。

类的方式实现

在类方法实现中，需注意潜在问题。首先观察可能出现的错误代码示例。

class Member(object):

 @classmethod
 def instance(cls, *args, **kwargs):
  if not hasattr(Member, "_instance"):
   Member._instance = Member(*args, **kwargs)
  return Member._instance

表面看该类似乎已实现单例，但在多线程环境下存在隐患。特别是当类的初始化过程包含耗时操作时，问题尤为明显。

具体代码如下：

#! /usr/bin/env python3
# .-*- coding:utf-8 .-*-

import time
import threading
import random


class Member(object):
 
 def __init__(self):
  time.sleep(random.randint(1,3))

 @classmethod
 def instance(cls, *args, **kwargs):
  if not hasattr(Member, "_instance"):
   Member._instance = Member(*args, **kwargs)
  return Member._instance


def task(arg):
 obj = Member.instance()
 print(obj)

for i in range(5):
 t = threading.Thread(target=task, args=[i,])
 t.start()

执行该代码会导致实例化多个对象，从而使单例模式失效。

针对此问题，自然想到引入锁机制进行控制。因此，对上述代码进行修改：

#! /usr/bin/env python3
# .-*- coding:utf-8 .-*-


import time
import threading
import random


class Member(object):
 _instance_lock = threading.Lock()

 def __init__(self):
  i = random.randint(1, 3)
  print(i)
  time.sleep(i)

 @classmethod
 def instance(cls, *args, **kwargs):
  with Member._instance_lock:
   if not hasattr(Member, "_instance"):
    Member._instance = Member(*args, **kwargs)
  return Member._instance


def task():
 obj = Member.instance()
 print(obj)

for i in range(5):
 threading.Thread(target=task,).start()

然而，上述代码仍存在缺陷：一旦实例已创建，每次调用instance方法时仍会请求锁，这会影响性能。因此，需对代码进行进一步优化：

@classmethod
 def instance(cls, *args, **kwargs):
  if not hasattr(Member, "_instance"):
   with Member._instance_lock:
    if not hasattr(Member, "_instance"):
     Member._instance = Member(*args, **kwargs)
  return Member._instance

经过上述改进，即可实现一个支持多线程环境的单例模式。

总结

以上为本文全部内容，希望这些内容对您的学习或工作具有参考价值。如有疑问，欢迎留言交流，感谢支持。