Go中实现线程安全单例唯一推荐方式是sync.Once，因其通过原子操作+互斥锁确保初始化函数只执行一次、解决内存可见性问题且调用者阻塞等待；而if判空非原子，多goroutine可能同时通过导致重复初始化，加锁易出错且性能差。
Go 里实现线程安全单例，唯一推荐方式是 sync.Once；其他写法要么不安全，要么冗余，要么难维护。
为什么不能只用 if instance == nil 判断
因为 if 本身不是原子操作。多个 goroutine 同时执行时，可能都看到 instance == nil，然后各自创建新实例——结果出现多个“单例”。日志里会看到初始化逻辑被执行多次，或者 fmt.Printf("%p", GetInstance()) 打印出不同地址。
常见错误现象：Singleton instance created multiple times、对象状态不一致、资源重复申请（比如连了两次数据库）。
- 即使后续加
sync.Mutex，也容易漏掉第二次判空（即没做双重检查），或忘记defer mu.Unlock()导致死锁 - 手动同步无法保证内存可见性：一个 goroutine 写完
instance，另一个可能读到未完全构造的对象（Go 编译器和 CPU 可能重排指令） - 每次调用都要抢锁，性能比
sync.Once差不少
sync.Once 是怎么工作的
sync.Once 底层用原子操作 + 轻量互斥锁，确保 Do 里的函数**只执行一次**，且所有并发调用者会**阻塞等待初始化完成**，而不是各自返回 nil 或旧值。
立即学习“go语言免费学习笔记（深入）”；
它天然解决三个关键问题：执行一次、内存可见、调用者同步等待。
-
once.Do(func())中的函数必须无参数、无返回值；所以依赖项（如配置、连接字符串）得提前准备好 - 一旦
Do执行过（哪怕内部 panic），后续调用直接跳过，不再尝试重试 -
instance必须声明在Do外部作用域，否则闭包里赋值对外不可见 - 不要写
once.Do(&initFunc)—— Go 不支持函数指针传参，编译报错：cannot use &initFunc (type *func()) as type func()
带错误返回的单例怎么写
sync.Once.Do 不接受返回值，所以初始化失败不能靠函数返回 error。正确做法是把 error 和实例一起存为包级变量，并在 GetXXX() 函数里统一检查。
- 声明
var instance *DB, err error，注意err是指针类型或全局变量，避免值拷贝失效 -
once.Do闭包里执行instance, err = openDB(...)，出错就赋值给err - 调用方拿到
nil实例时，必须主动检查err != nil，不能默认“没 panic 就成功” - 不需要额外加锁保护
err变量：sync.Once已保证执行顺序，*error赋值是原子的
var (
db *DB
err error
once sync.Once
)
func GetDB() (*DB, error) {
once.Do(func() {
db, err = openDB("mysql://...")
})
return db, err
}
饿汉式 init() 适合什么场景
init() 确实只运行一次，也线程安全，但它在包加载阶段就执行，**无法延迟初始化**，也不支持传参或错误传播。
- 适合构造开销极小、必然会被使用、且不依赖运行时环境的对象（比如纯内存结构体、常量配置）
- 如果初始化要读文件、连网络、解析 YAML，
init()里失败只能panic或log.Fatal，无法让上层决定重试或降级 - 测试时无法 mock 或跳过：你没法在单元测试中“绕过”
init()重新初始化单例 - 启动变慢：哪怕程序根本用不到这个单例，它也被提前创建了
真正需要按需加载、可测试、可错误处理的场景，sync.Once 是不可替代的。
