sync.Once用于确保操作仅执行一次,适用于单例、配置加载等场景;其Do方法保证并发安全,但若函数panic则视为已执行,后续不再重试。

在Go语言中,sync.Once 是一个用于确保某个操作在整个程序运行过程中只执行一次的同步原语。它常用于单例模式、配置初始化、资源加载等场景,保证并发安全的同时避免重复执行。
sync.Once 的基本用法
sync.Once 只有一个方法 Do(f func()),传入一个函数,该函数只会被执行一次,无论有多少个 goroutine 同时调用。
示例:
var once sync.Once
var instance *MyStruct
func getInstance() *MyStruct {
once.Do(func() {
instance = &MyStruct{}
})
return instance
}
多个 goroutine 调用 getInstance() 时,内部的初始化函数只会执行一次,其余调用会直接返回已创建的实例。
立即学习“go语言免费学习笔记(深入)”;
使用场景举例
常见用途包括:
示例:加载配置
var config map[string]string
var loadOnce sync.Once
func LoadConfig() map[string]string {
loadOnce.Do(func() {
config = make(map[string]string)
// 模拟读取配置
config["api_key"] = "12345"
config["timeout"] = "30"
})
return config
}
注意事项
使用 sync.Once 需要注意以下几点:
- 传给 Do 的函数如果发生 panic,会被认为已执行,后续调用不会再次尝试。
- 多个 Once 实例互不影响,每个实例独立控制一次执行。
- Do 的参数必须是 func() 类型,不能传带参数的函数,可通过闭包捕获外部变量。
基本上就这些。sync.Once 简单高效,是 Go 并发编程中确保初始化安全的重要工具。不复杂但容易忽略细节,比如 panic 导致无法重试的问题,使用时需谨慎处理函数内部错误。










