Golang单例模式实现：sync.Once线程安全详解

单例模式在Go中常用sync.Once实现线程安全的初始化。使用包级变量配合sync.Once可确保实例只被创建一次，避免并发问题。具体步骤：定义instance和Once变量；在GetInstance函数中调用once.Do执行初始化逻辑；返回实例。相比手动加锁或原子操作，sync.Once更简洁、安全且性能良好，适合大多数场景。

单例模式在Go语言中很常见，尤其是需要确保某个对象在整个程序中只被初始化一次的场景。比如数据库连接池、配置加载器等。要实现线程安全又简洁的单例，sync.Once是一个非常合适的工具。

单例模式的基本结构

在Go中，最简单的单例实现方式是使用一个包级变量，并配合一个获取该变量的函数。例如：

var instance *SomeType

func GetInstance() *SomeType {
    if instance == nil {
        instance = &SomeType{}
    }
    return instance
}

这看起来没问题，但问题在于：不是线程安全的。如果有多个goroutine同时调用GetInstance()，就可能创建多个实例。

所以你需要一种机制来确保即使在并发环境下也只会初始化一次。这时候就可以用到 sync.Once。

sync.Once 的作用和使用方法

sync.Once 是 Go 标准库提供的一个工具，专门用来保证某个操作只执行一次。它的结构很简单：

type Once struct {
    // 包含隐藏字段
}

func (o *Once) Do(f func())

你只需要定义一个 sync.Once 变量，然后把初始化逻辑放在 Do 方法里，传入一个函数即可。无论多少个goroutine并发调用，这个函数都只会执行一次。

来看一个具体的例子：

var (
    instance *SomeType
    once     sync.Once
)

func GetInstance() *SomeType {
    once.Do(func() {
        instance = &SomeType{}
    })
    return instance
}

这段代码就能保证即使在高并发下，instance 也只会被初始化一次。

使用时需要注意的几个点：

• once.Do() 中的函数不能有返回值，也不能带参数。
• 如果传入的函数 panic 了，Once 会认为这次调用已经执行过，后续不会再执行。
• Once 应该作为包级变量或结构体字段存在，不要每次都在函数里新建。

为什么不用加锁或原子操作？

你可能会想：“我也可以自己用互斥锁或者原子操作来判断是否已初始化。”确实可以，但这样写起来更复杂，容易出错。

比如自己加锁实现的话，常见的“双重检查”模式虽然性能更好，但也更容易出bug：

if instance == nil {
    mu.Lock()
    defer mu.Unlock()
    if instance == nil {
        instance = &SomeType{}
    }
}

这种写法虽然能避免每次都加锁，但稍不注意就会因为内存重排等问题导致错误。而 sync.Once 已经帮你封装好了这些细节，简单又安全。

小结一下

用 sync.Once 实现单例是最推荐的方式，因为它：

• 简洁明了，易于维护
• 线程安全，无需额外处理并发逻辑
• 性能不错，标准库已经优化过

当然，如果你的初始化逻辑特别简单（比如只是赋值），也可以考虑懒加载+原子指针的方式。但在大多数情况下，用 Once 是最稳妥的选择。

基本上就这些。