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 单例模式。