Golang单例模式实现：sync.Once线程安全详解

sync.Once 能确保初始化只执行一次，从而实现线程安全的单例。1. 使用 sync.Once 可以避免并发访问时重复创建实例；2. 实现方式是将初始化逻辑放在 once.Do 中；3. 注意 Do 只执行一次、避免长时间阻塞、适合懒加载；4. 多例或可变单例可用 map + mutex 实现。

单例模式在 Golang 中实现起来相对简单，但要确保线程安全却并不容易。sync.Once 是 Go 标准库提供的一个非常实用的工具，它能保证某个操作只执行一次，非常适合用来实现线程安全的单例。

为什么需要 sync.Once？

在并发环境下，多个 goroutine 同时访问单例实例时，可能会导致重复初始化的问题。比如两个协程同时判断实例为 nil，都进入创建逻辑，结果就生成了两个实例，违背了单例原则。

这时候就需要一种机制来确保初始化只执行一次，无论有多少个协程同时尝试访问。
sync.Once 就是为此而生的。

如何用 sync.Once 实现单例？

基本思路是：定义一个结构体作为单例对象，并使用 sync.Once 来控制其初始化过程。下面是常见的写法：

type Singleton struct{}

var instance *Singleton
var once sync.Once

func GetInstance() *Singleton {
    once.Do(func() {
        instance = &Singleton{}
    })
    return instance
}

这个写法的关键点在于：

• once.Do(...) 只会执行一次，不管有多少个 goroutine 调用。
• 初始化逻辑放在匿名函数中传给 Do 方法。
• 即使多次调用 GetInstance()，也只会创建一个实例。

使用注意事项和常见问题

虽然 sync.Once 很方便，但在实际使用中还是有一些细节需要注意：

✅ Do 函数只能执行一次，不能重置

一旦 Once 的 Do 被执行过，后续所有调用都不会再执行里面的函数。如果你希望重新初始化，只能自己重新定义一个新的 Once 实例或者绕开它。

❗ 不要在 Do 里做长时间阻塞操作

因为 Once.Do 内部是通过锁来实现同步的，如果里面执行的操作耗时太久，会影响其他等待的协程性能。

? 可以结合懒加载使用

有时候我们不希望在程序启动时就初始化某些资源，而是等到第一次被使用时才创建，这正是 sync.Once 和懒加载结合的最佳场景。

拓展：多例或可变单例怎么办？

如果你的需求不是严格的“只有一个实例”，而是“最多有几个实例”或者“根据条件返回不同实例”，那就不适合用 sync.Once 了。这个时候可以考虑：

• 使用 sync.Once + map 缓存不同配置下的实例
• 或者直接用 sync.Mutex 自己控制更复杂的逻辑

例如：

var instances = make(map[string]*Singleton)
var mu sync.Mutex

func GetInstance(key string) *Singleton {
    mu.Lock()
    defer mu.Unlock()

    if inst, exists := instances[key]; exists {
        return inst
    }

    inst := &Singleton{}
    instances[key] = inst
    return inst
}

这种做法可以根据 key 来控制不同的“单例”。

总结一下

用 sync.Once 实现单例是最推荐的方式，因为它简洁、线程安全、不容易出错。只要注意不要在里面做复杂操作，一般就能满足大多数需求。

基本上就这些。