单例指针实现必须用 sync.Once，直接 var instance *Singleton 加 if 判断会引发竞态；sync.Once 通过 atomic 和互斥锁确保 Do 只执行一次，且所有调用者获得同一实例地址。
单例的指针实现必须用 sync.Once
直接用 var instance *Singleton 加 if 判断会引发竞态——多个 goroutine 同时进入 nil 分支，各自 new 一次。Go 不保证变量初始化的原子性，尤其指针类型。
正确做法是把创建逻辑锁进 sync.Once 的 Do 方法里：
var (
instance *Singleton
once sync.Once
)
func GetInstance() *Singleton {
once.Do(func() {
instance = &Singleton{}
})
return instance
}
-
sync.Once内部用atomic和互斥锁双重保障，确保Do只执行一次，且所有调用者拿到的是同一个地址 - 不要在
once.Do外提前声明instance并赋初值（比如instance = &Singleton{}），那等于放弃懒加载，也失去线程安全意义 - 如果单例构造函数可能 panic，
sync.Once仍只执行一次——但 panic 会导致后续所有GetInstance()调用直接 panic，这点容易被忽略
全局变量初始化和 init() 函数不是一回事
很多人以为在包级声明 var globalVar = NewSingleton() 就是“初始化”，其实这是包初始化阶段的表达式求值，发生在 init() 之前，且无并发保护。
它适合无状态、无依赖、纯内存构造的对象（比如空结构体或常量配置），但不适用于需要连接数据库、读文件、或依赖其他包 init 顺序的单例。
立即学习“go语言免费学习笔记（深入）”；
-
init()函数执行顺序由 Go 编译器按包依赖拓扑排序，不可控；而sync.Once延迟到首次调用，时机明确 - 包级变量初始化若调用外部函数（如
os.Open），失败时无法重试，panic 会中断整个程序启动流程 - 测试时难以 mock：包级变量在 import 时就已初始化，无法在 test 文件中重置
为什么不用 unsafe.Pointer 或反射绕过 sync.Once
有人想用 unsafe.Pointer 手动管理内存地址，或用反射判断是否已初始化——这既没必要，又危险。
Go 的 sync.Once 实现本身极轻量（底层是 uint32 + mutex），没有性能瓶颈；而手动操作指针会破坏内存安全，且在 GC 栈扫描、逃逸分析中引入不确定性。
-
unsafe.Pointer绕过类型系统，一旦对象被 GC 回收（比如误写成局部变量返回地址），运行时可能崩溃或静默错误 - 反射判断字段是否为 nil 在指针类型上不可靠：
reflect.ValueOf(nil).IsNil()会 panic，必须先IsValid()检查，代码反而更啰嗦 - Go 官方文档明确推荐
sync.Once作为单例初始化的标准方式，社区工具（如 vet、staticcheck）也会对裸指针单例发出警告
带参数的单例怎么处理
如果单例构造需要传参（比如配置路径、超时时间），不能把参数塞进 GetInstance()——那会破坏单例语义（多次调用传不同参数，该信谁？）。
正确方式是在包初始化时预留配置入口，或用选项模式封装，确保首次调用后参数不可变：
type Option func(*Singleton)
func WithTimeout(t time.Duration) Option {
return func(s *Singleton) {
s.timeout = t
}
}
var (
instance *Singleton
once sync.Once
opts []Option
)
func SetOptions(options ...Option) {
opts = options // 只允许在 GetInstance 之前调用
}
func GetInstance() *Singleton {
once.Do(func() {
instance = &Singleton{}
for _, opt := range opts {
opt(instance)
}
})
return instance
}
注意 SetOptions() 必须在第一次 GetInstance() 前完成，否则会被忽略——这个约束靠文档和代码审查保障，Go 本身无法强制。
真正难处理的是运行时才确定的参数（比如从环境变量动态读取），这时候得接受：单例初始化时机和参数获取时机必须对齐，不能指望“先拿实例再喂参数”。
