Go 语言单例模式详解：从基础到 sync.Once 的最佳实践

简单单例模式的局限

单例模式旨在保证一个类仅有一个实例，并提供一个访问它的全局访问点。在 Go 语言中，最直观的做法是利用指针和包级变量来保持同一引用。

package singleton

type singleton struct{}

var instance = &singleton{}

func GetSingleton() *singleton {
    return instance
}

该实现主要由三部分构成：

• 私有结构体：singleton，限制外部直接实例化。
• 全局变量：instance，在程序启动或包加载时立即被创建。
• 获取函数：GetSingleton，用于返回已存在的实例。

虽然这种方式最简单，但它存在明显的缺点：实例在 init() 阶段或第一次包加载时就已完成创建。如果初始化过程涉及大量资源计算或 I/O 操作，会拖慢程序的启动速度。因此，我们需要一种能实现“延迟初始化”的方案。

加锁的单例模式

为了解决懒加载问题，可以先判断实例是否为 nil。但在高并发环境下，多个 Goroutine 同时调用获取函数可能会导致多次实例化。最简单的解决方案是使用 sync.Mutex 进行串行控制。

var mutex sync.Mutex

func GetSingleton() *singleton {
    mutex.Lock()
    defer mutex.Unlock()
    
    if instance == nil {
        instance = &singleton{}
    }
    return instance
}

通过互斥锁，我们保证了临界区代码的原子性。但这也带来了性能隐患：每次获取单例都要经历一次加锁和解锁的过程。在高并发场景下，这种频繁的锁竞争会成为系统的瓶颈，导致性能显著下降。

双重检查锁定（Double-Checked Locking）

为了兼顾性能与并发安全，业界通常采用“双重检查”策略。核心思想是先进行一次无锁判断，只有当发现实例未初始化时，才进入加锁逻辑。

func GetSingleton() *singleton {
    // 第一重检查：提高非并发情况下的效率
    if instance == nil {
        mutex.Lock()
        defer mutex.Unlock()
        
        // 第二重检查：防止多个协程同时通过第一重检查后重复创建
        if instance == nil {
            instance = &singleton{}
        }
    }
    return instance
}

这种模式的工作原理如下：

1. 快速路径：如果实例已经被创建，第一层 if 判断直接返回结果，无需加锁开销。
2. 安全路径：仅当首次进入且需要创建实例时，才申请锁。在持有锁的状态下再次检查实例是否为空，确保即使有多个协程排队等待锁，最终也只有一个协程执行初始化操作。

Go 官方推荐：sync.Once

上述手动管理锁的方式虽可行，但对于初学者而言容易出错（如内存可见性问题）。Go 语言标准库提供了更优雅、更安全的选择 —— sync.Once。

var once sync.Once

func GetSingleton() *singleton {
    once.Do(func() {
        instance = &singleton{}
    })
    return instance
}

sync.Once 是 Go 内置并发原语，专门用于保证函数只被执行一次。其优势在于：

• 零性能损耗：一旦初始化完成，后续调用几乎是无状态的，开销极小。
• 线程安全：内部处理了所有底层同步细节，避免了手写锁可能带来的竞态条件。
• 代码简洁：语义清晰，直接表达了“只执行一次”的意图。

此机制同样适用于配置文件初始化、数据库连接池建立等只需触发一次的场景。当变量仅需在首次访问时完成初始化时，优先选用 sync.Once。

以上就是 Go 语言单例模式示例详解的详细内容，更多关于 Go 语言单例模式的资料请关注本站其它相关文章！