17370845950

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 变量设为公有（首字母大写）并直接导出，否则外部可随意修改或重新赋值，破坏单例语义。

• 保持 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 显式控制。