Go中单例必须用sync.Once实现懒汉式，因包级变量导出会破坏单例语义，而sync.Once保证首次初始化、零开销、线程安全；饿汉式仅适用于无依赖、必用且轻量的极端场景。
为什么不能直接导出包级变量
直接把 instance 声明为大写（如 Instance *Singleton）并导出，看似省事，实则破坏单例语义。外部包可随意赋值：singleton.Instance = &Singleton{}，瞬间绕过所有初始化逻辑，导致状态不一致或竞态。Go 没有私有构造函数，唯一可控入口必须是函数——GetInstance() 是强制守门人，不是可选便利。
sync.Once 是并发安全的唯一可靠选择
用 sync.Mutex 加锁实现懒汉式单例，每次调用 GetInstance() 都要加锁解锁，性能损耗明显；双重检查锁定（DCL）写法复杂且易错，比如忘记对 instance 做 volatile 语义保证（Go 中需靠 atomic 或 sync.Once）。而 sync.Once 底层用原子操作 + 状态机，只在首次调用时触发初始化，后续调用零开销，且天然线程安全。
-
once.Do()只接受无参函数，所以初始化逻辑必须闭包捕获所需参数 - 不要复用同一个
sync.Once实例做多个不同初始化——它只认“执行过”和“没执行过”，不会区分上下文 - 若初始化过程可能 panic，
once.Do()仍会标记为“已执行”，后续调用直接返回 nil 实例，需在外层兜底处理
带配置参数的单例怎么写才不踩坑
数据库连接、日志器等单例往往依赖启动参数。常见错误是让 GetInstance() 接收参数并每次校验——这既无法保证“首次生效”，又破坏了单例的幂等性。正确做法是：只允许首次调用传参，后续忽略。
示例：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
var (
instance *ConfigurableDB
once sync.Once
config *DBConfig // 包级私有，仅首次有效
)
func GetInstance(cfg *DBConfig) *ConfigurableDB {
once.Do(func() {
if cfg == nil {
cfg = &DBConfig{Addr: "localhost:5432"}
}
config = cfg
instance = &ConfigurableDB{conn: connect(cfg)}
})
return instance
}
- 参数
cfg不参与后续调用判断，避免多次传入不一致配置引发未定义行为 - 初始化失败（如连接超时）应提前 panic 或记录 fatal 日志，否则
instance为 nil，下游空指针 panic 更难排查 - 不要试图在
once.Do外部做if instance != nil判断再传参——那会失去sync.Once的保护意义
饿汉式只适合极轻量、必用的场景
包加载时就初始化（var instance = &Singleton{}）确实简单，但隐患明确：如果初始化含 I/O、网络请求或耗时计算，会拖慢整个程序启动，且无法按需延迟加载。更严重的是，它无法接收运行时配置——所有参数必须硬编码或从全局环境变量读取，丧失灵活性。
除非满足以下全部条件，否则别用饿汉式：
- 结构体无字段，或所有字段都是常量/字面量
- 初始化过程绝对不涉及任何外部依赖（文件、网络、系统调用）
- 该单例在程序生命周期中 100% 会被使用，且无条件早于任何其他逻辑
实际项目里，满足这三条的单例极少。多数时候，sync.Once 懒汉式才是兼顾安全、性能与可控性的默认解法。
