Go中单例模式通过sync.Once实现线程安全的懒加载:定义私有结构体、包级指针和once变量,GetInstance()内用once.Do确保初始化仅一次,避免饿汉式资源浪费且无需手动加锁。

在 Go 语言中实现单例模式,核心目标是:**确保一个类型在整个程序生命周期中只存在一个实例,并提供全局访问点**。Go 没有类和构造函数,但可通过包级变量 + 同步控制(如 sync.Once)安全、简洁地实现线程安全的单例。
使用 sync.Once 保证初始化仅一次
sync.Once 是 Go 标准库提供的轻量级同步原语,其 Do 方法能确保传入的函数只被执行一次,天然适配单例的“懒加载+仅初始化一次”需求。
- 定义一个私有结构体(如
Config),避免外部直接实例化 - 声明一个包级指针变量(如
var instance *Config)和一个sync.Once变量 - 提供公开的获取实例函数(如
GetInstance()),内部用once.Do包裹初始化逻辑
完整可运行示例
以下是一个带日志和简单配置字段的单例实现:
package main
import (
"fmt"
"sync"
)
type Config struct {
Env string
Port int
}
var (
instance *Config
once sync.Once
)
func GetInstance() *Config {
once.Do(func() {
instance = &Config{
Env: "production",
Port: 8080,
}
fmt.Println("Config instance created")
})
return instance
}
func main() {
c1 := GetInstance()
c2 := GetInstance()
fmt.Printf("c1 == c2: %t\n", c1 == c2) // true
}
运行输出:Config instance created 仅出现一次,且 c1 和 c2 指向同一地址。
立即学习“go语言免费学习笔记(深入)”;
为什么不用 init() 或全局变量直接初始化?
直接赋值(如 instance := &Config{...})虽简单,但属于“饿汉式”,会在包加载时立即创建——可能浪费资源,或依赖未就绪的环境(如配置未读取)。而 sync.Once 实现的是“懒汉式”,首次调用时才初始化,更灵活可控。同时它天然并发安全,无需手动加锁。
进阶:支持带参数的单例(如依赖注入)
若需初始化时传参(例如从配置文件读取),可将初始化逻辑封装为工厂函数,并在 GetInstance 中调用:
- 定义一个初始化函数(如
newConfigFromYaml(path string)) - 在
once.Do中调用该函数并赋值给instance - 首次调用
GetInstance("config.yaml")时加载,后续调用忽略参数(因只执行一次)
注意:参数仅对首次生效,后续调用无法改变实例状态——这符合单例语义。
基本上就这些。Go 的单例不复杂但容易忽略并发安全,sync.Once 是最推荐的方式,干净、高效、无副作用。










