sync.Once.Do 参数必须是无参无返回值函数，不能直接传带返回值的构造函数；正确做法是用包级变量+闭包赋值，确保线程安全与懒加载。
sync.Once.Do 为什么不能直接传入带返回值的函数
sync.Once.Do 的参数类型是 func()，也就是无参无返回值的函数。如果你写了个返回 *Singleton 的构造函数，比如 newSingleton()，直接传给 Do 是编译不通过的——它不会帮你接收返回值，更不会赋值给某个变量。
常见错误写法：once.Do(newSingleton)，看似调用了构造逻辑，但返回的实例彻底丢失了。
- 正确做法是把实例变量声明在包级或结构体字段中，在闭包里完成赋值
- 闭包内必须用指针或可寻址变量，否则赋值无效（例如局部变量
s := newSingleton()后再赋值，对外不可见） - 不要试图在
Do外部“等待”或“检查”是否已初始化——sync.Once本身不提供状态查询接口
标准单例实现：包级变量 + sync.Once 闭包赋值
最常用、线程安全、且符合 Go 惯例的写法是把实例和 sync.Once 都声明为包级变量，用匿名函数包裹初始化逻辑。
var (
instance *Singleton
once sync.Once
)
<p>func GetInstance() <em>Singleton {
once.Do(func() {
instance = &Singleton{ /</em> 初始化字段 */ }
})
return instance
}这种写法的关键点：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
instance必须是包级变量（或至少是调用方能访问到的可寻址变量），否则闭包里的赋值无法被外部读取 - 如果
Singleton构造开销大或依赖外部资源（如 DB 连接），建议在Do内做错误处理并缓存失败状态（sync.Once不重试，首次失败后永远返回 nil） - 不要在
GetInstance里加锁或额外同步——sync.Once已保证只执行一次且内存可见
为什么不用 init 函数替代 sync.Once
init 确实只执行一次，但它发生在包导入时、所有变量初始化阶段，无法延迟到第一次使用时才创建实例（即不是懒加载），也不支持依赖运行时参数（如配置、命令行 flag）。
典型不适用场景：
- 需要根据
os.Args或环境变量选择不同实现：init时这些值可能还没解析 - 构造过程可能失败（如连接远程服务），你希望调用方能感知错误，而不是让整个程序 panic 或静默失败
- 测试时想替换 mock 实例——
init无法重置，而包级变量+sync.Once可配合测试重置（只要暴露重置函数）
sync.Once 在结构体内嵌时的陷阱
有人会把 sync.Once 嵌入自定义结构体，比如：type Singleton struct { once sync.Once; data string }，然后在方法里调用 s.once.Do(...)。这看似封装性更好，但容易出错：
- 如果
Singleton是值类型（非指针）传参，每次调用方法都拿到副本，once字段也被复制，失去“只执行一次”的语义 - 即使传指针，多个不同实例共享同一个
once字段也违背单例本意——每个实例应独立控制自己的初始化 - 真正需要“每个对象首次调用某方法时仅执行一次”的场景，应该用独立的
sync.Once字段，但此时它就不是单例模式，而是 lazy-init 模式了
单例的核心约束是「全局唯一实例」，不是「每个对象初始化一次」。别为了封装把 sync.Once 错放到结构体里。
