Go 里用 sync.Once 实现线程安全单例最可靠：它通过原子操作+互斥锁确保初始化函数只执行一次，所有 goroutine 等待完成，避免双重检查遗漏和半初始化对象问题。
Go 里用 sync.Once 实现线程安全单例最可靠
直接结论：不用自己手写双重检查锁（double-checked locking），Go 标准库的 sync.Once 就是为此设计的——它保证函数只执行一次，且自带同步语义，比手动加锁更轻量、更不易出错。
常见错误是试图用 sync.Mutex + 检查变量是否为 nil 来实现，但漏掉内存可见性问题：goroutine 可能读到未完全初始化的对象（尤其是字段较多或含指针/切片时）。sync.Once 内部用 atomic 和互斥锁组合，确保初始化完成前所有字段对其他 goroutine 可见。
- 初始化函数必须无参数、无返回值（
func()类型），所以需提前捕获依赖，比如闭包捕获配置或传入全局变量 - 如果初始化函数 panic，
sync.Once会认为“已执行”，后续调用不再尝试——这符合预期，避免反复 panic；但要注意日志和恢复逻辑 - 不要在
sync.Once.Do()里做耗时操作（如网络请求、大文件读取），否则首次调用者会阻塞所有后续调用者
atomic.LoadPointer 不适合直接做单例载入
有人看到 “原子载入” 就想用 atomic.LoadPointer 配合 unsafe.Pointer 手动管理指针，这是高危操作。Go 的 GC 不保证被 unsafe.Pointer 引用的对象不被回收，除非该指针被 Go 原生类型（如 *T）持有并逃逸到堆上。
更实际的问题是：即使你用 atomic.StorePointer 存了地址，也无法原子地「检查 + 赋值 + 返回」——这需要 compare-and-swap（CAS），而单次 LoadPointer 只读，不解决竞态。真要底层控制，得用 atomic.CompareAndSwapPointer 自己实现 once 逻辑，但没必要，也容易漏掉 barrier 或误用 unsafe。
-
atomic.LoadPointer适合读取已由其他机制（如sync.Once）安全发布的指针，比如从一个已初始化完毕的全局变量中读 - 若强行用 CAS 实现单例，需配合
unsafe.Pointer(&instance)和类型转换，代码可读性差，且 Go 1.22+ 对unsafe更严格，CI 可能报错 - 标准库中
sync.Once底层确实用了atomic指令（如atomic.LoadUint32），但它封装了全部细节，你不需要也不应该绕过它
带参数的单例？用函数选项或延迟绑定
单例常被误认为“必须零参数构造”。实际上，很多场景需要传配置（如数据库 DSN、超时时间），但又不能每次调用都新建实例。解决方案不是放弃单例，而是把参数决策提前。
- 用函数选项模式（functional options）：定义
type Option func(*Singleton)，在第一次Do()时应用所有选项，之后固定 - 或把参数存在包级变量（如
var defaultDSN = "..."），初始化函数读它；启动时由init()或main()提前设置 - 避免在
Do()闭包里捕获局部变量并修改它——因为Do()可能被多个 goroutine 并发触发，导致数据竞争
示例片段：
var (
instance *DB
once sync.Once
)
func GetDB(dsn string) *DB {
once.Do(func() {
instance = &DB{dsn: dsn} // 注意：dsn 必须是 Do 调用前就确定的值
instance.connect()
})
return instance
}
这里 dsn 是调用方传入，但必须确保所有调用传相同值，否则行为未定义——所以更推荐把 dsn 设为包变量或用选项模式封装。
测试单例时别忘了并发和重置
单元测试里最容易忽略两点：一是并发调用是否真只初始化一次，二是多次运行测试时单例状态残留。Go 的包变量不会自动重置，sync.Once 状态也是包级的。
- 用
go test -race跑并发测试，例如起 100 个 goroutine 同时调GetDB()，再断言初始化函数只被调一次（可通过计数器或日志验证） - 测试后无法“清空”
sync.Once，所以涉及单例的测试最好放在独立包，或用构建标签（//go:build unit）隔离；不要在同一个包里混写多个单例测试 - 如果单例依赖外部资源（如 mock HTTP server），务必在测试结束时显式关闭，否则端口占用或连接泄漏会导致后续测试失败
真正麻烦的从来不是“怎么写单例”，而是“怎么证明它在线上高并发下不崩、不漏、不重复初始化”。sync.Once 解决了核心同步问题，剩下的——参数传递、测试覆盖、资源清理——才是落地时卡住人的地方。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
