Golang单例模式与sync.Once使用详解

编程并不是一个机械性的工作，而是需要有思考，有创新的工作，语法是固定的，但解决问题的思路则是依靠人的思维，这就需要我们坚持学习和更新自己的知识。今天golang学习网就整理分享《Golang单例模式实现与sync.Once用法详解》，文章讲解的知识点主要包括，如果你对Golang方面的知识点感兴趣，就不要错过golang学习网，在这可以对大家的知识积累有所帮助，助力开发能力的提升。

sync.Once 是 Go 中实现单例最推荐的方式，它通过 Do 方法确保初始化函数仅执行一次。使用时定义一个 Once 实例和单例变量，在 GetInstance 函数中调用 once.Do 来初始化对象，保证并发安全、代码简洁且性能良好。常见误区包括传参错误和复用 Once 对象，此外还有全局变量、init 函数和加锁等其他单例实现方式，但均不如 sync.Once 安全高效。

单例模式在Go语言中很常见，尤其是在需要确保某个对象只被初始化一次的场景下。实现方式有很多种，但最推荐、最安全的方式是使用标准库中的 sync.Once。

sync.Once 是什么？

sync.Once 是 Go 标准库提供的一个工具结构体，它保证某个函数只会被执行一次，即使在并发环境下也能线程安全地完成初始化工作。它的定义很简单：

type Once struct {
    // contains filtered or unexported fields
}

它只有一个方法 Do(f func())，传入的函数 f 只会被执行一次，后续调用都会被忽略。

这正好符合单例模式的需求：实例只创建一次，多次获取都是同一个对象。

如何用 sync.Once 实现单例？

实现起来非常简单，基本结构如下：

type Singleton struct{}

var instance *Singleton
var once sync.Once

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

在这个例子中，无论多少个 goroutine 同时调用 GetInstance()，once.Do 都能保证内部的匿名函数只执行一次，从而确保 instance 只被初始化一次。

这种方式的优点很明显：

• 线程安全，不需要自己加锁
• 代码简洁清晰，逻辑直观
• 性能好，不会每次都加锁判断

常见误区和注意事项

虽然 sync.Once 很方便，但在使用过程中也有一些容易踩坑的地方：

✅ 必须传入无参数函数

once.Do() 接受的是一个没有参数的函数，所以如果你的初始化过程需要参数，那就要在闭包里处理清楚，不能直接传参进去。

例如这样是可以的：

once.Do(func() {
    instance = NewSingletonWithConfig(cfg)
})

但不要试图把 Do 当成可以传参执行的函数，它不是设计用来做这个的。

❌ 不要重复使用 Once 对象

每个 sync.Once 只应该用于一个初始化动作。如果你在一个结构体里复用了同一个 Once 对象去做多个初始化，可能会导致混乱。

比如下面这种写法就有问题：

var once sync.Once

func InitA() { once.Do(doA) }
func InitB() { once.Do(doB) } // 错误！InitA执行后，once已经触发过了

一旦其中一个初始化完成，另一个就永远不会再执行了。

单例还可以怎么写？为什么推荐 Once？

除了 sync.Once，还有几种常见的单例写法：

• 全局变量直接初始化
  比如 var instance = &Singleton{}
  这种方式最简单，但不适合需要延迟加载或有复杂初始化逻辑的情况。

• 使用 init 函数初始化
  利用包级 init() 函数来初始化单例
  优点是自动执行，缺点是控制力差，无法按需加载。

• 加锁实现（比如 Mutex）
  在并发访问时加锁判断是否已初始化
  虽然可行，但每次都要加锁判断，性能不如 Once 干净利落。

相比之下，sync.Once 的优势在于：

• 安全性高：官方封装，经过验证
• 性能好：只在第一次加锁，之后无开销
• 语义清晰：一看就知道是用来做“只执行一次”的任务

小细节补充

• once.Do() 中如果函数 panic 了，Once 会认为已经执行过，后续调用也不会再执行。
• 如果你希望即使失败也重试，就不能用 Once，得自己控制状态。
• Once 本身是可复制的吗？理论上不应该复制，因为其内部状态可能出错。最好作为包级变量或者结构体内嵌使用。

基本上就这些。用 sync.Once 实现单例是 Go 中最推荐的方式，不复杂但确实实用。

终于介绍完啦！小伙伴们，这篇关于《Golang单例模式与sync.Once使用详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！