Go生产代码唯一安全单例是sync.Once+包级指针变量且GetInstance()返回(*T, error)；手动判空线程不安全，sync.Once须包级声明，初始化失败必须显式返回error，带参单例应分离NewService与GetService。
Go 语言里只有一种值得写进生产代码的单例实现：用 sync.Once + 包级指针变量，且 GetInstance() 必须返回 (*T, error)。 其他写法要么线程不安全，要么初始化失败无法感知，要么测试时无法重置——不是“不够好”，而是会出线上问题。
为什么不能用 if instance == nil 手动判断
看似省事，实则危险。多个 goroutine 同时调用 GetInstance() 时，可能都看到 instance 为 nil，然后各自执行初始化逻辑，最终创建多个实例。
- 典型错误现象：
nil pointer dereference、数据库连接被重复dial、配置加载两次导致内存泄漏 - 即使加了
sync.Mutex，也容易漏掉锁内二次判空（double-check），或初始化中途 panic 导致状态不一致 - Go 内存模型不保证写操作对其他 goroutine 的立即可见，手动判断无法提供
happens-before语义
sync.Once 必须是包级变量，不能局部声明
sync.Once 的作用是“标记某段逻辑只执行一次”。如果把它放在函数内部，每次调用都会新建一个，彻底失去意义。
- 正确位置：包级变量（如
var once sync.Once）或结构体字段（需指针接收者方法调用） - 错误写法：
func GetInstance() *Service { var once sync.Once // ❌ 每次调用都新建，无效 once.Do(func() { ... }) } - 结构体内嵌时，注意接收者必须是指针：
func (s *Client) Get() {...}，否则once字段在副本中不生效
初始化失败必须显式返回 error，不能靠 init()
init() 函数签名固定，不能返回 error，一旦初始化失败（比如数据库连不上、配置文件读取失败），整个程序直接 panic 退出，排查困难。
立即学习“go语言免费学习笔记（深入）”；
- 正确做法：用两个包级变量 ——
instance *Service和err error，在once.Do闭包里统一赋值 - 调用方必须检查：
svc, err := GetInstance() if err != nil { log.Fatal(err) } -
sync.Once记住的是“执行过”，不是“成功过”。一旦初始化 panic，后续调用直接返回缓存的nil, err，不会重试 - 需要重试或兜底逻辑？那就不该由单例承担，而应由上层控制生命周期，或改用依赖注入
带参数的单例怎么写
硬编码全局变量 + init() 或无参 GetInstance() 都不可取。参数固化会导致无法测试、难以复用、环境隔离失败。
- 推荐模式：
func NewService(cfg Config) *Service负责构造，func GetService() (*Service, error)封装单例逻辑 - 参数应在首次调用
GetService()前通过其他方式传入（如命令行解析后存入包变量，或用func SetConfig(...)预设） - 测试时可直接调用
NewService(testCfg)构造新实例，不污染全局状态 - 避免写
var db *sql.DB+func InitDB(dsn string)—— 这破坏封装，且无法防止重复Init
真正麻烦的点不在语法，而在于初始化函数里的副作用是否可逆：发了一次 HTTP 请求、写了一个临时文件、启动了一个监听端口……一旦失败，sync.Once 就把它“钉死”了。这种场景下，单例不该背这个锅。
