Go单例模式核心是确保GetInstance()返回同一指针且并发安全，唯一可靠方案是sync.Once配合包级指针变量，它通过原子操作和内存屏障保证初始化函数仅执行一次，避免手写锁的竞态风险。
Go里没有构造函数，别被术语带偏
Go语言没有类、没有构造函数，所谓“用构造函数实现单例”是误用 Java/C++ 语境下的说法。实际要解决的问题只有一个：GetInstance() 返回的必须是同一个指针地址，且多 goroutine 并发调用时不能创建多个实例。关键不是“封装构造逻辑”，而是控制**赋值时机**和**赋值原子性**。
sync.Once 是唯一靠谱的线程安全方案
所有手写 if instance == nil + sync.Mutex 的组合都容易出错——要么漏掉二次判空，要么锁粒度不对，要么忘记 defer Unlock。而 sync.Once.Do() 内部已用原子操作+内存屏障保证：函数只执行一次，且所有 goroutine 等待初始化完成才返回结果。
-
once和instance必须是包级变量，不能定义在函数内 -
instance类型必须是指针（如*DBClient），否则赋值是副本，外部拿不到初始化结果 - 初始化函数里避免耗时操作（如连数据库），否则会阻塞所有后续调用
- 如果初始化可能失败（比如配置缺失），
sync.Once.Do本身不返回 error，需额外声明err error包级变量并检查
传参初始化怎么办？别在 GetInstance 里做
想给单例传配置、连接字符串或依赖项？sync.Once.Do 接收的函数签名是 func()，无法直接传参。常见错误是把参数闭包进 Do 函数里，但参数若来自运行时（如 flag 或环境变量），可能还没解析完就执行了。
- 推荐做法：在
main()或 init 阶段显式调用一次Init(config Config)，内部用sync.Once控制；GetInstance()保持无参 - 不推荐：在
GetInstance(name string)里根据参数返回不同实例——这已不是单例，而是对象池 - 更稳妥的替代：用接口+依赖注入，把单例作为参数传入，而非全局获取
init() 初始化单例？除非你确定它不依赖任何运行时输入
init() 确实只执行一次，但它发生在包加载阶段，早于 flag.Parse()、配置加载、甚至 main() 执行。这意味着：
立即学习“go语言免费学习笔记（深入）”；
- 拿不到命令行参数、环境变量、配置文件内容
- 无法返回 error，失败只能 panic 或 log，上层无法恢复
- 单元测试时无法 mock 或重置，因为
init()在测试启动前就跑完了 - 如果初始化开销大（比如加载模型），而程序多数路径根本不用它，纯属浪费
真正需要延迟初始化、可测、可错的单例，init() 不是选项。
