sync.Once.Do 是 Go 单例最安全的选择，因其用原子操作+互斥锁确保初始化函数只执行一次且完全串行化，妥善处理竞态、重复初始化及 panic 后状态标记等边界问题。
sync.Once.Do 为什么是 Go 单例最安全的选择
因为 sync.Once 内部用原子操作 + 互斥锁双重保障，确保 Do 中的初始化函数**只执行一次且完全串行化**，连竞态读写、重复初始化、panic 后重试这些边界都处理好了。不用自己手写 if m == nil + sync.Mutex 套路，那套容易漏掉「检查-加锁-再检查」（double-check）或 panic 导致后续调用卡死。
常见错误现象：nil pointer dereference 或多个 goroutine 同时执行初始化逻辑，比如数据库连接被重复 dial；或者用了 sync.Mutex 但忘了在加锁后再次检查实例是否已创建。
-
sync.Once不关心初始化函数是否 panic：一旦 panic，Do会把状态标记为“已完成”，后续调用直接返回，不会重试 —— 这是设计使然，不是 bug - 初始化函数里别做不可逆的副作用（如发 HTTP 请求、写文件），否则 panic 后单例永远处于“已尝试但失败”的假死状态
- 不要把
sync.Once实例本身作为全局变量暴露出去，它只该是单例结构体的私有字段
标准单例结构体怎么写才不踩坑
单例必须封装成一个结构体类型，sync.Once 是它的字段，不是包级变量；初始化逻辑收在私有方法里，对外只暴露一个线程安全的获取函数。
使用场景：配置加载、日志实例、DB 连接池、全局缓存管理器 —— 凡是「初始化开销大 + 全局唯一 + 多 goroutine 并发访问」的都适用。
立即学习“go语言免费学习笔记（深入）”；
- 结构体字段必须导出（首字母大写），否则外部无法访问其方法；但
sync.Once字段本身应小写（once sync.Once），避免被误用 - 获取函数名统一用
NewInstance或GetInstance，别叫Get—— 后者语义模糊，看不出是否带初始化逻辑 - 如果单例依赖参数（如 config struct），不要把参数塞进
GetInstance；改用func NewMySingleton(cfg Config) *MySingleton显式构造，再由上层控制单例生命周期
示例：
type DBManager struct {
db *sql.DB
once sync.Once
}
func (m *DBManager) GetDB() *sql.DB {
m.once.Do(func() {
// 这里做真实初始化，比如 sql.Open
m.db = connectDB()
})
return m.db
}
sync.Once 和 init() 函数到底该选谁
init() 是包加载时执行，适合无依赖、纯内存、绝对静态的初始化（比如预设 map、常量注册）；sync.Once 是运行时按需触发，支持错误处理、参数注入、延迟加载 —— 绝大多数业务单例该用后者。
性能影响很小：sync.Once.Do 首次调用有原子指令开销，之后就是普通内存读取；而 init() 在程序启动时就阻塞所有包初始化，可能拖慢启动速度，还无法感知环境变量或配置文件是否就绪。
- 用
init()初始化 HTTP client？错 —— 你没法在init()里读os.Getenv("ENV")做环境判断 - 用
sync.Once初始化 logger？对 —— 可以等配置加载完再 set level、add hook - 两者混用危险：比如在
init()里调了GetInstance()，但此时sync.Once还没定义好，可能造成 init 循环或未定义行为
测试时怎么绕过 sync.Once 的“只执行一次”限制
单元测试需要重置单例状态，但 sync.Once 没提供 Reset 方法 —— 所以不能把 sync.Once 放在全局或包级变量里，必须让它属于可重建的结构体实例。
关键点：测试中重新 new 一个结构体，就等于有了全新的 once sync.Once 字段，天然隔离。
- 别在测试里试图反射修改
sync.Once内部字段，Go 1.22+ 已禁止 unsafe 修改 runtime 类型 - 如果单例强依赖外部服务（如 Redis），测试时用接口抽象依赖，再传 mock 实现，而不是 mock
sync.Once - 集成测试中真要复用单例？那就接受它“一次生效”，把测试顺序安排成「先跑初始化类测试，再跑业务类测试」，比硬 hack 更可靠
最容易被忽略的是：单例对象内部状态是否真正线程安全。sync.Once 只保初始化一次，不保你后续对 m.db 或 m.cache 的读写安全 —— 该加锁的地方还得加锁，该用 sync.Map 的别手软。
