用 sync.Once 而不是手动加锁，因其通过原子操作+互斥锁+happens-before确保初始化完成前所有字段写入对后续调用者100%可见，避免双重检查锁在Go中因内存重排序导致的半成品对象问题。
为什么用 sync.Once 而不是自己加锁？
因为手动用 sync.Mutex 做“首次检查 + 加锁 + 再检查”（即双重检查锁，DCL）在 Go 里既不安全也不必要。Go 的内存模型不保证普通变量读写的重排序行为，instance 可能被部分初始化就对其他 goroutine 可见，导致拿到一个半成品对象。而 sync.Once 内部用原子操作 + 互斥锁 + happens-before 语义做了完整封装，确保初始化完成前，所有字段写入对后续调用者 100% 可见。
-
sync.Once是标准库验证过的、零配置的“一次开关”，比手写逻辑更轻、更稳 - 它没有额外依赖，不需要你管锁的生命周期、释放时机或 panic 后状态
- 性能上，未初始化时走一次锁路径，初始化后全是无锁原子读，比每次都要锁快得多
sync.Once.Do 的函数里 panic 了怎么办？
这是线上最常踩的坑：once.Do(func() { ... }) 中一旦 panic，once 内部的 done 标志位会被设为 true，后续所有调用直接返回（甚至可能返回 nil），且永远不会再尝试初始化——你拿不到实例，也收不到错误。
- 不要把可能 panic 的操作（如
json.Unmarshal、os.Open、http.Get）裸写进Do函数里 - 必须前置错误处理：先校验文件是否存在、端口是否通、配置 key 是否合法，再执行核心初始化
- 如果真需要容错重试，得自己封装一层，比如用
struct{ once sync.Once; err error; value *T }，把错误暴露给调用方
带参数的单例怎么初始化？
sync.Once.Do 只接受 func() 类型，不能直接传参。但 Go 支持闭包捕获外部变量，所以“参数”要提前准备好，不能边调用边传。
- 推荐方式：把参数定义为包级变量（如
config Config），在调用GetInstance()前由上层注入好 - 示例中常见错误是把参数当函数参数传进去，比如
GetInstance(c)，然后在Do里用c—— 这会导致竞态：多个 goroutine 并发调用时，c值可能已被覆盖 - 若需多组不同参数的实例（如连接不同数据库），那就不是单例了，应改用对象池或工厂函数，别硬套
sync.Once
什么场景不该用 sync.Once？
它只解决“只执行一次”的问题，不是万能初始化工具。
立即学习“go语言免费学习笔记（深入）”；
- 初始化逻辑极简单（比如只是
&MyStruct{}），直接用包级变量赋值更清晰，也省去运行时判断开销 - 需要热更新或多次重载（如配置监听变化），
sync.Once就该让位给sync.RWMutex+ 显式 reload 接口 -
init()函数里完全没必要用sync.Once：它本身已由 Go 运行时串行执行，且早于任何 goroutine 启动
once.Do，而是想清楚：这个“一次”，到底是对整个进程有效，还是对某个上下文有效；失败了要不要告诉调用方；以及——你确定它真的只能有一个吗？ 
