Go中单例模式需用sync.Once确保全局变量仅初始化一次，通过私有实例变量和GetInstance函数提供线程安全访问，禁止导出变量，支持带参初始化但需保证首次参数生效。
在 Go 语言中实现单例模式，核心是确保一个结构体在整个程序生命周期中只被初始化一次，并且所有调用都返回同一个实例。Go 没有类和构造函数的概念，但可以通过包级变量 + sync.Once 安全地实现线程安全的单例。
使用 sync.Once 实现线程安全单例
sync.Once 是 Go 标准库提供的工具，保证其包裹的函数只会被执行一次，天然适合单例初始化场景。这是最推荐、最简洁、最安全的方式。
- 定义一个私有全局变量（如
instance *Singleton）和一个sync.Once变量 - 提供一个公开的获取实例函数（如
GetInstance()），内部用once.Do()包裹初始化逻辑 - 初始化逻辑中创建结构体指针并赋值给全局变量
示例代码：
package singleton
import "sync"
type Singleton struct {
data string
}
var (
instance *Singleton
once sync.Once
)
func GetInstance() *Singleton {
once.Do(func() {
instance = &Singleton{data: "initialized"}
})
return instance
}
避免直接导出全局变量
不要将 instance 变量设为公有（首字母大写）并直接导出，否则外部可随意修改或重新赋值，破坏单例语义。
立即学习“go语言免费学习笔记（深入）”；
- 保持
instance为小写（包内私有） - 只通过
GetInstance()函数访问，控制入口唯一 - 若需防止反射或 unsafe 修改，可在结构体中加入未导出字段（如
mu sync.Mutex）作为“防篡改标记”，但这属于防御性设计，非必需
支持带参数的单例（延迟初始化 + 配置注入）
如果单例依赖外部配置（如数据库连接字符串），可改造 GetInstance 为接收参数的版本，但要注意：多次调用时参数必须一致，否则行为未定义。更稳妥的做法是使用“首次调用传参，后续忽略”的策略。
- 定义一个私有初始化函数，接受配置参数
- 用
sync.Once保证只初始化一次；首次调用传入的参数生效，后续调用忽略 - 可配合
sync.RWMutex或原子操作记录是否已初始化，但通常sync.Once已足够
示例片段：
var (
instance *Singleton
once sync.Once
initArgs struct{ name string }
)
func GetInstanceWithConfig(name string) *Singleton {
once.Do(func() {
initArgs = struct{ name string }{name: name}
instance = &Singleton{data: "configured: " + name}
})
return instance
}
不推荐的方式：仅靠 var 初始化（无并发保护）
以下写法看似简单，但存在竞态风险：
var instance = &Singleton{data: "bad"} // 包级变量初始化
问题在于：如果结构体初始化过程较重（如打开文件、连接网络），它会在 init() 阶段执行，无法按需延迟；更重要的是，多个 goroutine 同时首次访问该变量时，Go 不保证初始化顺序的原子性（尤其涉及复杂表达式时）。因此，务必使用 sync.Once 显式控制。
