Go中无构造函数，sync.Once是最稳妥的单例初始化方式，通过包级变量+once.Do实现延迟且仅一次的线程安全初始化，避免nil指针、多实例及重复初始化问题。
Go 里没有“构造函数”，sync.Once 是最稳妥的初始化方式
Go 没有类和构造函数，所谓单例本质是「全局变量 + 延迟且仅一次的初始化」。sync.Once 天然保证这点，比手写 if once == nil 加锁安全得多——它能防住并发 goroutine 同时触发初始化，而手动加锁容易漏掉竞态或死锁。
常见错误现象：nil pointer dereference（没初始化就用）、多个实例（并发调用导致多次 init）、init 逻辑被重复执行（比如打开两次文件、连两次数据库）。
- 必须把单例变量声明为包级变量（
var instance *Singleton），不能放在函数内 -
sync.Once.Do()里只放初始化逻辑，别塞业务代码；返回值要显式赋给包级变量 - 不要在
init()函数里做重操作（如网络请求），它阻塞包加载，且无法 error 处理
var (
instance *DBClient
once sync.Once
)
func GetDBClient() *DBClient {
once.Do(func() {
instance = &DBClient{conn: connectToDB()}
})
return instance
}
带参数的单例怎么写？用闭包封装 sync.Once 初始化逻辑
单例常需传参（比如数据库地址、配置对象），但 GetDBClient() 不能每次传参——那就不是单例了。正确做法是：参数在首次调用时传入，之后忽略；或拆成两步：先 SetConfig()，再 GetInstance()。
使用场景：测试时替换 mock 实例、不同环境加载不同配置、CLI 工具按 flag 初始化服务。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 参数必须通过闭包捕获，不能依赖外部可变变量（比如全局 config 变量被后续修改）
- 如果允许重置（如测试中），需额外加锁控制
once状态，但会破坏单例语义，慎用 - 避免把参数类型设为
interface{}，丢失类型安全；优先用结构体或具体类型
func NewHTTPClient(timeout time.Duration) *http.Client {
var client *http.Client
var once sync.Once
return func() *http.Client {
once.Do(func() {
client = &http.Client{Timeout: timeout}
})
return client
}
}() // 立即执行，返回单例函数
为什么不用 init() 或包级变量直接初始化？
包级变量直接初始化（var db = connectDB()）看似简洁，但会在 import 时立即执行，无法延迟、无法 error 处理、无法按需加载。而 init() 更危险：它在 main 执行前运行，所有依赖它的包都得等它完成，一旦出错（如配置缺失、网络不通），整个程序 panic，且堆栈难定位。
性能影响：提前初始化浪费资源（比如 CLI 工具只用了子命令 A，却初始化了 B/C 的单例）；兼容性影响：某些环境（如 serverless）要求冷启动快，init 阶段耗时直接超时。
- 包级变量初始化适合无副作用、纯内存、确定成功的值（如
var ErrInvalid = errors.New("invalid")） - 任何含 I/O、网络、配置读取、第三方库调用的操作，一律推迟到首次
GetXXX()时 - 如果必须用
init()，只做轻量注册（如registry.Register("db", newDB)），不真正创建实例
测试时怎么替换单例？靠接口 + 可导出变量控制
单例最难测，因为状态跨测试用例残留。Go 标准做法是：定义接口（如 type DBer interface { Query(...) }），让单例实现它，再把包级变量声明为该接口类型——这样测试时可直接赋值 mock 实现。
容易踩的坑：忘记在测试后恢复原实例（导致后续测试受影响）、mock 实现没覆盖全部方法（panic）、用 unsafe 或反射强行改 unexported 字段（破坏封装且不稳定）。
- 单例变量名用大写（
DB而非db），确保测试包能访问并重置 - 提供
ResetForTest()辅助函数，内部重置sync.Once和实例变量（注意：Go 标准库sync.Once不可重置，需自定义或用指针包装） - 避免在
TestMain里统一 reset，应按需在每个测试前后控制，更精准
var DB DBer = &realDB{}
func TestQuery(t *testing.T) {
old := DB
DB = &mockDB{}
defer func() { DB = old }()
// run test...
}
单例真正的复杂点不在语法，而在生命周期边界——谁负责释放资源？什么时候该销毁？Go 没有析构函数，sync.Once 只管创建，不管回收。如果单例持有了连接、文件句柄或 goroutine，得额外设计关闭逻辑，并确保调用时机不冲突。 
