Golang如何实现单例模式详解sync.Once的线程安全用法-Golang-PHP中文网

Golang如何实现单例模式详解sync.Once的线程安全用法

P粉602998670

发布： 2025-07-19 09:55:01

原创

408人浏览过

sync.once 能确保初始化只执行一次，从而实现线程安全的单例。1. 使用 sync.once 可以避免并发访问时重复创建实例；2. 实现方式是将初始化逻辑放在 once.do 中；3. 注意 do 只执行一次、避免长时间阻塞、适合懒加载；4. 多例或可变单例可用 map + mutex 实现。

Golang如何实现单例模式详解sync.Once的线程安全用法

单例模式在 Golang 中实现起来相对简单，但要确保线程安全却并不容易。sync.Once 是 Go 标准库提供的一个非常实用的工具，它能保证某个操作只执行一次，非常适合用来实现线程安全的单例。

为什么需要 sync.Once？

在并发环境下，多个 goroutine 同时访问单例实例时，可能会导致重复初始化的问题。比如两个协程同时判断实例为 nil，都进入创建逻辑，结果就生成了两个实例，违背了单例原则。

这时候就需要一种机制来确保初始化只执行一次，无论有多少个协程同时尝试访问。
sync.Once 就是为此而生的。

立即学习“go语言免费学习笔记（深入）”；

如何用 sync.Once 实现单例？

基本思路是：定义一个结构体作为单例对象，并使用 sync.Once 来控制其初始化过程。下面是常见的写法：

type Singleton struct{}

var instance *Singleton
var once sync.Once

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

登录后复制

这个写法的关键点在于：

once.Do(...) 只会执行一次，不管有多少个 goroutine 调用。
初始化逻辑放在匿名函数中传给 Do 方法。
即使多次调用 GetInstance()，也只会创建一个实例。

使用注意事项和常见问题

虽然 sync.Once 很方便，但在实际使用中还是有一些细节需要注意：

✅ Do 函数只能执行一次，不能重置

一旦 Once 的 Do 被执行过，后续所有调用都不会再执行里面的函数。如果你希望重新初始化，只能自己重新定义一个新的 Once 实例或者绕开它。

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

查看详情

❗ 不要在 Do 里做长时间阻塞操作

因为 Once.Do 内部是通过锁来实现同步的，如果里面执行的操作耗时太久，会影响其他等待的协程性能。

? 可以结合懒加载使用

有时候我们不希望在程序启动时就初始化某些资源，而是等到第一次被使用时才创建，这正是 sync.Once 和懒加载结合的最佳场景。

拓展：多例或可变单例怎么办？

如果你的需求不是严格的“只有一个实例”，而是“最多有几个实例”或者“根据条件返回不同实例”，那就不适合用 sync.Once 了。这个时候可以考虑：

使用 sync.Once + map 缓存不同配置下的实例
或者直接用 sync.Mutex 自己控制更复杂的逻辑

例如：

var instances = make(map[string]*Singleton)
var mu sync.Mutex

func GetInstance(key string) *Singleton {
    mu.Lock()
    defer mu.Unlock()

    if inst, exists := instances[key]; exists {
        return inst
    }

    inst := &Singleton{}
    instances[key] = inst
    return inst
}

登录后复制

这种做法可以根据 key 来控制不同的“单例”。