如何在 Go 中使用 sync.Once 实现单例模式-Golang-PHP中文网

sync.once.do 参数必须是无参无返回值函数，不能直接传带返回值的构造函数；正确做法是用包级变量+闭包赋值，确保线程安全与懒加载。

如何在 go 中使用 sync.once 实现单例模式

sync.Once.Do 为什么不能直接传入带返回值的函数

sync.Once.Do 的参数类型是 func()，也就是无参无返回值的函数。如果你写了个返回 *Singleton 的构造函数，比如 newSingleton()，直接传给 Do 是编译不通过的——它不会帮你接收返回值，更不会赋值给某个变量。

常见错误写法：once.Do(newSingleton)，看似调用了构造逻辑，但返回的实例彻底丢失了。

正确做法是把实例变量声明在包级或结构体字段中，在闭包里完成赋值
闭包内必须用指针或可寻址变量，否则赋值无效（例如局部变量 s := newSingleton() 后再赋值，对外不可见）
不要试图在 Do 外部“等待”或“检查”是否已初始化——sync.Once 本身不提供状态查询接口

标准单例实现：包级变量 + sync.Once 闭包赋值

最常用、线程安全、且符合 Go 惯例的写法是把实例和 sync.Once 都声明为包级变量，用匿名函数包裹初始化逻辑。

var (
    instance *Singleton
    once     sync.Once
)
<p>func GetInstance() <em>Singleton {
once.Do(func() {
instance = &Singleton{ /</em> 初始化字段 */ }
})
return instance
}</p>

这种写法的关键点：

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

instance 必须是包级变量（或至少是调用方能访问到的可寻址变量），否则闭包里的赋值无法被外部读取
如果 Singleton 构造开销大或依赖外部资源（如 DB 连接），建议在 Do 内做错误处理并缓存失败状态（sync.Once 不重试，首次失败后永远返回 nil）
不要在 GetInstance 里加锁或额外同步——sync.Once 已保证只执行一次且内存可见