单例模式的核心目标是保证一个类在程序运行期间只存在一个实例，并提供一个全局访问点。在Golang的多协程并发场景下，如果单例的初始化逻辑没有做并发控制，多个协程同时触发初始化流程就可能导致实例被重复创建，破坏单例的约束。因此实现线程安全的单例模式是Golang开发中的常见需求。
什么是线程安全的单例模式
线程安全的单例模式指的是在多线程或者多协程的并发环境中，单例的实例化过程不会被多个执行流同时执行，最终只会生成一个唯一的实例，且后续所有获取实例的操作都返回同一个对象。在Golang中，由于天然支持多协程并发，所以实现单例时必须考虑goroutine并发调用初始化函数的情况。
常见的线程安全单例实现方案
1. 使用sync.Once实现
sync.Once是Golang标准库提供的并发原语，它的Do方法可以保证传入的函数只执行一次，无论有多少个协程同时调用，这是实现单例最推荐的方式，代码简洁且性能优秀。
package singleton
import (
"sync"
)
// 定义单例结构体
type Singleton struct {
data string
}
var (
instance *Singleton
once sync.Once
)
// GetInstance 获取单例实例
func GetInstance() *Singleton {
// once.Do保证init函数只执行一次
once.Do(func() {
instance = &Singleton{
data: "单例初始化数据",
}
})
return instance
}
sync.Once内部通过原子操作和互斥锁结合实现，首次调用Do时会执行初始化函数，后续所有调用都会直接跳过，不需要额外的锁竞争，性能表现很好。
2. 使用互斥锁实现
也可以通过互斥锁手动控制初始化流程的并发访问，这种方式需要开发者自己处理锁的加锁和解锁逻辑，还要注意避免重复初始化的问题。
package singleton
import (
"sync"
)
type Singleton struct {
data string
}
var (
instance *Singleton
mutex sync.Mutex
)
func GetInstance() *Singleton {
// 先加锁保证并发安全
mutex.Lock()
defer mutex.Unlock()
// 判断实例是否已经初始化
if instance == nil {
instance = &Singleton{
data: "互斥锁实现单例",
}
}
return instance
}
这种方式的缺点是每次获取实例都需要加锁，即使实例已经初始化完成，还是会有锁的开销，性能比sync.Once的方案差一些。
3. 双重检查锁定实现
双重检查锁定是在加锁之前先判断实例是否为空，如果已经初始化就直接返回，避免不必要的锁竞争，不过在Golang中需要注意内存可见性的问题。
package singleton
import (
"sync"
"sync/atomic"
)
type Singleton struct {
data string
}
var (
instance *Singleton
mutex sync.Mutex
// 用原子变量标记实例是否已经初始化
initialized uint32
)
func GetInstance() *Singleton {
// 第一次检查，避免不必要的锁竞争
if atomic.LoadUint32(&initialized) == 1 {
return instance
}
mutex.Lock()
defer mutex.Unlock()
// 第二次检查，防止多个协程同时通过第一次检查后重复初始化
if instance == nil {
instance = &Singleton{
data: "双重检查锁定单例",
}
atomic.StoreUint32(&initialized, 1)
}
return instance
}
这种方式通过原子变量保证初始化状态的可见性，减少了锁的使用次数，但是实现逻辑比sync.Once复杂，容易出错，一般不建议优先使用。
不同方案对比
下面是三种常见实现方案的对比：
| 实现方案 | 代码复杂度 | 性能表现 | 推荐程度 |
|---|---|---|---|
| sync.Once | 低 | 优秀 | 最高 |
| 互斥锁 | 中等 | 一般 | 中等 |
| 双重检查锁定 | 高 | 较好 | 较低 |
注意事项
- 单例的实例变量需要声明为包内私有，避免外部直接修改，保证单例的唯一性。
- 如果单例需要携带配置信息，建议在初始化时完成所有配置的赋值，避免在后续使用中修改实例状态，防止出现并发读写的问题。
- 不要在单例的初始化函数中做太多耗时的操作，否则会阻塞其他等待初始化的协程，影响程序的启动速度。
实际开发中优先选择sync.Once实现单例模式，它既保证了线程安全，又不需要开发者处理复杂的并发逻辑，是最稳妥的实现方式。如果遇到特殊的场景需要自定义初始化逻辑，再考虑其他方案。
GolangSingleton_Pattern线程安全并发控制修改时间：2026-06-28 04:36:28