sync.Once 是 Go 中实现线程安全单例最可靠、轻量的方式；它通过原子操作和内存屏障避免指令重排，保证初始化完成才返回，比 mutex 或双重检查更简洁安全。
Go 语言中实现线程安全的单例，sync.Once 是最可靠、最轻量的方式；用 mutex 加锁也能工作，但容易写错或带来不必要开销。
为什么不用双重检查锁定（Double-Check Locking）？
Go 的内存模型不保证未同步的读写顺序，手动实现 DCL 容易因指令重排导致返回未完全初始化的对象。标准库 sync.Once 内部已用原子操作和内存屏障正确处理了这个问题，无需自行模拟。
-
sync.Once.Do()天然保证函数只执行一次，且所有 goroutine 看到的是同一份初始化完成后的结果 - 没有竞态风险，也不需要判断指针是否为 nil
- 比手写
mutex+if检查更简洁、更不易出错
推荐写法：sync.Once + 包级变量
这是 Go 社区公认的标准做法，兼顾线程安全、延迟初始化和可测试性。
package singleton
import "sync"
type instance struct {
data string
}
var (
once sync.Once
single *instance
)
func GetInstance() *instance {
once.Do(func() {
single = &instance{data: "initialized"}
})
return single
}
- 全局变量
single初始为nil，首次调用GetInstance()才真正构造对象 -
once.Do()内部已做同步，多个 goroutine 并发调用时，仅有一个会执行初始化逻辑 - 后续调用直接返回已初始化的指针，零额外开销
如果必须支持重置或测试场景怎么办？
标准 sync.Once 不可重用，但可通过封装一个可重置的结构体绕过限制：
立即学习“go语言免费学习笔记（深入）”；
type ResettableSingleton struct {
once sync.Once
value *instance
mu sync.RWMutex
}
func (r *ResettableSingleton) Get() *instance {
r.mu.RLock()
v := r.value
r.mu.RUnlock()
if v != nil {
return v
}
r.once.Do(func() {
r.mu.Lock()
defer r.mu.Unlock()
r.value = &instance{data: "initialized"}
})
return r.value
}
func (r *ResettableSingleton) Reset() {
r.mu.Lock()
defer r.mu.Unlock()
r.value = nil
r.once = sync.Once{} // 注意：sync.Once 不能复用，需重新赋值
}
- 测试时可调用
Reset()清空状态，避免单例污染其他 test case - 读多写少场景下，用
RWMutex提升并发读性能 - 注意
sync.Once是一次性结构，重置时必须新建实例，否则Do()不再生效
真正要注意的不是“怎么写单例”，而是“是否真的需要单例”。多数情况下，依赖注入（DI）比全局单例更利于解耦和测试；只有当对象创建开销极大、且确实需全局唯一实例（如数据库连接池、配置管理器）时，才值得引入 sync.Once 单例模式。
