17370845950

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 不可重用，但可通过封装一个可重置的结构体绕过限制：

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