sync.once 能确保初始化只执行一次，从而实现线程安全的单例。1. 使用 sync.once 可以避免并发访问时重复创建实例；2. 实现方式是将初始化逻辑放在 once.do 中；3. 注意 do 只执行一次、避免长时间阻塞、适合懒加载；4. 多例或可变单例可用 map + mutex 实现。
单例模式在 Golang 中实现起来相对简单，但要确保线程安全却并不容易。sync.Once 是 Go 标准库提供的一个非常实用的工具，它能保证某个操作只执行一次，非常适合用来实现线程安全的单例。
为什么需要 sync.Once？
在并发环境下，多个 goroutine 同时访问单例实例时，可能会导致重复初始化的问题。比如两个协程同时判断实例为 nil，都进入创建逻辑，结果就生成了两个实例，违背了单例原则。
这时候就需要一种机制来确保初始化只执行一次，无论有多少个协程同时尝试访问。sync.Once 就是为此而生的。
立即学习“go语言免费学习笔记（深入）”；
如何用 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 实现单例是最推荐的方式，因为它简洁、线程安全、不容易出错。只要注意不要在里面做复杂操作，一般就能满足大多数需求。
基本上就这些。
