Go中单例模式需确保全局唯一实例且线程安全，推荐用sync.Once延迟初始化、小写结构体和构造函数实现伪私有，并兼顾测试可重置性，避免init初始化或无锁判空等陷阱。
在 Go 语言中实现单例模式，核心目标是：**确保一个类型在整个程序生命周期中只存在唯一实例，并且线程安全地提供访问入口**。Go 没有类和构造函数的概念，但可通过包级变量 + 初始化控制 + 同步机制优雅达成。
使用 sync.Once 保证初始化仅一次
sync.Once 是 Go 官方推荐的单例初始化方式，它能确保 Do 中的函数最多执行一次，天然支持并发安全。
典型写法如下：
- 定义一个私有全局变量（如
var instance *Singleton） - 定义一个私有
sync.Once变量 - 提供公开的获取实例函数，在其中调用
once.Do()延迟创建实例
这样既避免了包初始化时就创建（可能浪费资源），又防止多 goroutine 竞态创建多个实例。
立即学习“go语言免费学习笔记（深入）”；
私有化结构体与构造函数
Go 中没有访问修饰符，但可通过命名约定实现“伪私有”：
- 结构体名首字母小写（如
singleton），使其仅在当前包内可见 - 构造函数也小写（如
newSingleton()），不对外暴露创建能力 - 导出的获取函数（如
GetInstance()）是唯一合法入口
这种设计从 API 层面杜绝了外部直接 new 实例的可能，强化了单例语义。
考虑是否需要支持重置或测试友好性
生产代码中单例通常长期存活，但单元测试时可能需要重置状态或替换实例。可按需添加：
- 内部 reset 函数（仅测试文件调用，通过构建标签
//go:build test隔离） - 或使用接口+依赖注入替代强单例，提升可测性（如定义
type Service interface{...}，单例实现该接口）
不建议在业务逻辑里频繁重置单例，但为测试留出余地是良好实践。
避免常见陷阱
几个容易踩的坑要特别注意：
- 不要用 init() 直接初始化实例——虽能保证一次，但无法延迟加载，且无法处理初始化失败的错误返回
-
不要只靠包级变量 + if 判断——无锁情况下并发读写
instance == nil可能导致多次创建 -
慎用全局 mutex 包裹整个 GetInstance——会成为性能瓶颈；
sync.Once更轻量精准
基本上就这些。Go 的单例不复杂，但容易忽略并发和初始化时机这两个关键点。
