因为 if 判断非原子，多 goroutine 可能同时通过导致重复初始化；即使加锁也易出错且性能差；sync.Once 通过原子操作保障仅执行一次，更安全高效。
为什么不用全局变量加 if 判断来实现单例
因为 if 判断本身不是原子操作，多个 goroutine 同时执行时可能同时通过判断，导致多次初始化。哪怕加了 sync.Mutex，也得自己管理锁的生命周期、防止死锁、避免忘记解锁——出错概率高，且性能差（每次访问都要抢锁）。
常见错误现象：Singleton instance created multiple times 或日志里看到初始化逻辑被执行了两次以上。
- 使用场景：数据库连接池、配置加载器、日志实例等需要全局唯一且延迟初始化的对象
- 不推荐在 init() 里直接 new 实例，除非你确定它不依赖运行时参数或外部服务
- 性能影响：
sync.Once第一次调用Do有少量原子操作开销，之后是纯内存读取，比每次加锁快得多
sync.Once.Do 的正确写法和典型误用
sync.Once 的核心是 Do 方法，它保证传入的函数只执行一次。但很多人误以为“只要用了 Once 就万事大吉”，结果掉进闭包或变量作用域陷阱。
正确示例：
立即学习“go语言免费学习笔记（深入）”；
var once sync.Once
var instance *Config
func GetConfig() *Config {
once.Do(func() {
instance = &Config{...} // 初始化逻辑放在这里
})
return instance
}
容易踩的坑：
- 把
instance声明在Do函数内部：会导致外部拿不到引用，返回 nil - 在
Do里调用可能 panic 的函数，没做 recover：整个once就废了，后续调用直接跳过初始化（sync.Once不重试） - 重复声明多个
sync.Once字段用于同一个对象：没必要，一个就够了 - 误用
once.Do(&initFunc)传函数指针：Go 不支持，会编译报错cannot use &initFunc (type *func()) as type func()
带错误返回的单例初始化怎么处理
sync.Once.Do 签名是 func(f func())，不支持返回 error。如果初始化过程可能失败（比如读配置文件、连数据库），不能靠 Do 自身传达错误。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
解决方案是把 error 存到包级变量，配合额外标志位判断状态：
var (
once sync.Once
config *Config
err error
)
func LoadConfig(path string) error {
once.Do(func() {
config, err = loadFromPath(path) // 这里可能返回 error
})
return err
}
关键点：
- 必须在
Do外显式返回err，否则调用方永远不知道初始化是否成功 - 不要在
GetConfig()这类 getter 里隐藏错误：如果err != nil，应 panic 或返回零值+错误，而不是静默返回 nil - 并发调用
LoadConfig时，只有一个会真正执行loadFromPath，其他会等待并拿到相同结果（含 error）
sync.Once 不是万能的：哪些情况它帮不上忙
sync.Once 只保障“初始化函数只执行一次”，不负责实例本身的线程安全。如果单例对象的方法会修改内部状态，还得自己加锁或用原子操作。
例如：
type Counter struct {
mu sync.RWMutex
n int
}
func (c *Counter) Inc() { c.mu.Lock(); defer c.mu.Unlock(); c.n++ }
这里 sync.Once 能确保 Counter 实例只创建一次，但 Inc 方法仍需自己同步。
容易被忽略的地方：
- 单例对象包含 map、slice 等非线程安全类型时，读写都得加锁，
sync.Once完全不干预这个 - 如果初始化后需要热更新（比如动态 reload 配置），
sync.Once就不合适了，得换用sync.RWMutex+ 懒加载逻辑 - 测试时想重置单例状态？
sync.Once没提供 Reset 方法，只能靠包级变量重置 + 人工控制测试顺序
