不能直接用 new + 全局变量实现线程安全单例，因为包级变量初始化非并发安全，可能导致多次初始化；且指针共享不解决内部字段（如 map）的并发竞争，必须用 sync.Once 保障初始化一次，并对可变字段做同步封装。
为什么不能直接用 new + 全局变量实现线程安全单例
Go 的包级变量初始化是单次、非并发安全的——如果多个 goroutine 同时首次调用单例函数，sync.Once 未介入前可能触发多次初始化。更隐蔽的问题是：直接返回 &instance 但没加锁，后续并发读写该指针指向的结构体（比如带 map 或 slice 字段）仍会 panic。
- 全局变量声明如
var instance *Config本身不保证初始化时机，必须配合init()或首次访问逻辑 - 仅靠指针共享无法解决内部字段的并发竞争，指针只是地址，不是锁
- 若结构体含未同步的
map，哪怕只读，运行时也可能报fatal error: concurrent map read and map write
sync.Once 是唯一靠谱的初始化守门人
它内部用原子操作+互斥锁双重保障，确保 Do 中的函数最多执行一次。这是 Go 官方推荐的单例初始化方式，别自己手写 if instance == nil 判断。
- 错误写法：
if instance == nil { instance = &Config{} }—— 在竞态下可能新建多个实例 - 正确姿势：声明
var once sync.Once和var instance *Config，在获取函数里调用once.Do(func(){ instance = &Config{} }) -
sync.Once不影响性能：首次之后开销接近零，底层用uint32原子变量判断状态
指针单例必须配套结构体内存模型约束
返回 *Config 没问题，但结构体字段是否可并发访问，取决于你有没有做同步设计。指针本身不提供保护，它只是让所有调用者看到同一块内存。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 避免暴露可变字段：不要导出
Map map[string]string，改用Get(key string) string方法封装 - 若需写操作，字段本身应为
sync.Map或配sync.RWMutex，而不是依赖“大家用同一个指针就安全了” - 初始化后禁止修改指针值（如
instance = &OtherConfig{}），否则旧引用失效，且破坏单例语义
初始化失败时怎么处理？sync.Once 不支持重试
sync.Once.Do 只认“执行过”，不关心成功与否。如果初始化函数 panic 或返回错误，后续调用将永远拿不到有效实例，且无提示。
立即学习“go语言免费学习笔记（深入）”；
- 必须在
Do匿名函数内处理全部错误：日志、默认值兜底、或 panic（明确失败比静默空指针好） - 不要把 I/O 或网络调用放在
Do里——超时或失败会导致整个服务不可用；应预加载或异步初始化 - 测试时注意：
sync.Once状态无法重置，单元测试需用新进程或重构为可注入依赖
