如何在 Go 中实现一个基于双重检查锁（DCL）的高性能单例模式-Golang-PHP中文网

Go 不推荐手写双重检查锁单例，因 sync.Once 已是内存安全、零分配且经优化的成熟实现；手写易出错、难维护，且无法获得编译器特殊优化。

如何在 go 中实现一个基于双重检查锁（dcl）的高性能单例模式

为什么 Go 里不推荐手写双重检查锁（DCL）单例

Go 的 sync.Once 已经是经过充分验证、内存模型安全、且零分配的 DCL 实现。手动用 sync.Mutex + sync/atomic 模拟 DCL 不仅冗余，还极易出错——比如忘记用 atomic.LoadPointer 读取指针、漏掉 atomic.StorePointer 写入、或在非 unsafe.Pointer 场景误用原子操作。

更关键的是：Go 编译器和运行时对 sync.Once 有特殊优化，而自己写的 DCL 很难达到同等性能和安全性。

用 `sync.Once` 实现线程安全单例的正确姿势

核心是把初始化逻辑封装进一个无参函数，并由 Once.Do() 保证只执行一次。所有并发 goroutine 都会阻塞等待首次初始化完成，之后直接读取已初始化的变量。

sync.Once 内部已处理内存屏障，无需额外 atomic 或 unsafe
初始化函数不能带参数；如需传参，请提前闭包捕获或通过包级变量间接传递
如果初始化可能 panic，Once.Do() 会传播 panic，且后续调用仍会 panic —— 这是设计行为，不是 bug
不要重复声明多个 sync.Once 控制同一实例，否则失去“单例”语义

var (
    instance *Config
    once     sync.Once
)

func GetConfig() *Config {
    once.Do(func() {
        instance = &Config{Port: 8080, Timeout: 30}
    })
    return instance
}

什么时候真需要“双重检查”？比如延迟加载带参数的实例

若单例构造依赖运行时参数（如配置文件路径），又不想把参数硬编码进 Do 函数，可结合 sync.Once 和惰性初始化字段（如 sync.OnceValue（Go 1.21+）或自定义 once-with-arg 封装）。

但注意：sync.OnceValue 是为「返回值」设计的，它本身不接受参数；常见做法是用闭包捕获参数，或用 map/cache 管理多参数实例（此时已不属于严格单例）。

使用Go语言搭建家庭相册系统-相关课件

下载

Go 1.21+ 推荐：sync.OnceValue + 闭包，避免全局变量污染
低于 Go 1.21：可用 sync.Once + 包级变量 + 初始化函数工厂
切勿为“看起来更可控”而回退到手写 atomic.LoadUint32 + Mutex 的 DCL

// Go 1.21+
var getConfigOnce = sync.OnceValue(func(path string) (*Config, error) {
    data, _ := os.ReadFile(path)
    return parseConfig(data), nil
})

func GetConfigByPath(path string) (*Config, error) {
    return getConfigOnce(path)
}