go单例应使用sync.once+包级指针变量实现，兼顾线程安全、延迟初始化和错误处理；禁用全局变量直接赋值、init()初始化及导出实例变量，确保正确错误传播。
Go 语言里没有“类”，也没有构造函数，所谓单例不是靠“禁止 new”实现的，而是靠包级变量 + sync.Once 控制初始化时机——这是最稳妥、最符合 Go 风格的做法。
为什么不用全局变量直接赋值？
看似简单：var instance *MyService = &MyService{}，但存在两个硬伤：
- 如果
MyService初始化依赖外部资源（比如数据库连接、配置加载），它可能失败，而包级变量无法返回错误 - 多个 goroutine 并发 import 这个包时，
init()可能被多次执行（虽然 Go 规范保证包只初始化一次，但变量初始化表达式仍可能在init中被间接触发多次）
标准做法：用 sync.Once + 指针变量
这才是 Go 生态中公认的单例实现方式，兼顾线程安全、延迟初始化和错误处理能力：
package service
import (
"sync"
)
type MyService struct {
db *DB
}
var (
instance *MyService
once sync.Once
err error
)
func GetInstance() (*MyService, error) {
once.Do(func() {
instance, err = newMyService()
})
return instance, err
}
func newMyService() (*MyService, error) {
// 这里可以做任意初始化逻辑，比如：
// db, e := sql.Open(...)
// if e != nil { return nil, e }
// return &MyService{db: db}, nil
return &MyService{}, nil
}
-
once.Do保证newMyService()最多执行一次，且阻塞后续调用直到完成 - 错误通过包级
err变量传出，调用方必须检查GetInstance()返回的error - 不要把
instance设为导出变量（如Instance），否则绕过GetInstance就破坏了单例语义
常见误用：用 init() 实现单例？
有人会在 init() 里直接初始化实例，比如：
func init() {
instance = &MyService{}
}
这会导致：
- 无法返回初始化错误（
init()函数签名固定，不能有返回值） - 所有依赖该包的代码，在 main 启动前就强制初始化，哪怕根本用不到这个服务
- 单元测试难 mock —— 你没法在测试中“重置”已由
init()设置的实例
要不要加锁读取 instance？
不需要。只要写操作只发生在 once.Do 内，且 instance 是指针类型，那么后续并发读取是安全的：
- Go 内存模型保证：对一个变量的写操作（发生在
once.Do中）与后续所有读操作之间存在 happens-before 关系 - 只要你不把
instance赋值为 struct 值（即不写成instance = MyService{}），就不会触发隐式拷贝问题 - 如果真要用值类型单例（极少见），必须额外加
sync.RWMutex保护读，但通常没意义
真正容易被忽略的是错误传播路径——很多人写了 once.Do 却忘了暴露 err，导致下游 panic 或静默失败；还有人把 GetInstance 返回值设为 *MyService 而不是 (*MyService, error)，等于主动放弃错误处理能力。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
