sync.Once 仅保证初始化函数最多执行一次，不处理错误、不校验实例非空、不返回结果；生产单例需结合包级变量、错误捕获与非空检查。
直接用 sync.Once 是 Go 里唯一推荐的并发安全单例初始化方式，但它本身不是单例模式——只保证闭包最多执行一次，不处理错误、不保障实例非空、不自动返回结果。真正在生产环境可用的单例，必须把 sync.Once 和包级变量、错误处理、非空校验绑在一起用。
为什么不能只写 once.Do(func() { instance = &T{} })
这种写法看似简洁，实则埋了三个雷：
-
instance是包级指针变量，但初始化函数可能失败（比如构造函数 panic 或返回 nil），sync.Once完全不捕获也不暴露这个失败，后续调用GetInstance()直接返回nil，调用方无从感知 -
sync.Once标记“已完成”仅基于函数是否返回，不关心它是否成功；一旦 panic，状态仍被标记为 done，后续所有调用都跳过重试，instance永远是零值 - 如果初始化逻辑依赖外部资源（如配置、网络），首次调用时卡在
Do里，所有 goroutine 都会阻塞，HTTP handler 可能超时
sync.Once 必须是包级变量，且不能和 instance 拆开声明
常见误用是把 once sync.Once 放进结构体字段或函数局部作用域，这会让每次 new 或每次调用都拿到一个全新 sync.Once 实例，彻底失去“全局唯一”的意义。
- 正确姿势：两个变量都声明为包级变量，且类型一致，例如
var instance *Service和var once sync.Once - 更稳妥的做法是用结构体封装实例和错误：
var serviceInst struct{ instance *Service; err error }，避免instance和err不同步更新 - 绝不能把
once和instance分别声明为不同包级变量后，在不同函数里各自读写——Go 不保证跨变量赋值的原子性
带错误返回的单例函数怎么写才可靠
sync.Once.Do 的函数签名是 func(f func())，没法返回 error，所以错误必须显式存下来，并由获取函数统一暴露。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 初始化闭包里必须完成全部逻辑并赋值：
serviceInst = struct{ instance *Service; err error }{instance: s, err: err} - 对外函数签名必须是
func GetService() (*Service, error)，不能省略error返回值 - 调用方不能只判
instance == nil，必须检查err != nil；否则初始化失败时静默返回nil，极易引发后续 panic - 不要用两个独立包级变量（如
var instance *Service+var initErr error），因为并发读写时可能出现instance已赋值但initErr还没写入的情况
初始化函数里该做哪些事，不该做哪些事
懒加载不等于放任耗时操作在首次请求时爆发。Do 里的函数是同步阻塞的，它的执行时机直接影响服务响应。
- 该做的事：轻量构造、参数校验、内存对象创建；例如
&DB{conn: conn, logger: log}这类不依赖外部 IO 的组合 - 不该做的事：无 timeout 的 HTTP 请求、未设 deadline 的数据库 dial、读大文件、启动子进程；这些应提前在
main()中触发一次GetService()主动预热 - 必须做的事：初始化后加基础校验，比如
if s == nil { panic("service init failed") }，至少让 panic 发生在明确位置，而不是下游某个s.DoSomething()的 nil dereference - 要小心循环依赖：A 的初始化调
GetB()，B 又调GetA()，两个Do会互相等待，死锁
最易被忽略的点是：sync.Once 不区分“成功完成”和“panic 中断”，它只认“是否已调用”。一旦初始化函数 panic，那个 sync.Once 就永久失效，后续所有调用都跳过——你得自己在闭包里 recover、记录日志、并确保 instance 和 err 被正确设置，否则整个单例就不可用了。
