Go语言延迟加载单例模式完整教程-Golang-PHP中文网

必须用sync.Once，因包级变量+if判断存在数据竞争和部分初始化风险；init()无法传参或容错；手写Mutex易出错；而sync.Once通过原子检查+双重锁定确保仅执行一次且线程安全。

go语言延迟加载单例模式完整教程

Go 里延迟加载单例必须用 sync.Once，其他方式不是线程安全就是语义错误——哪怕只跑一个 goroutine，不加 once.Do() 也迟早出问题。

为什么不能只靠包级变量 + if 判断

常见写法：if instance == nil { instance = &MyService{} } 看似简单，但并发下会创建多个实例。Go 不保证包级变量赋值的原子性，go run -race 一跑就报 data race。更隐蔽的是：即使没 panic，instance 可能被部分初始化（比如字段还没来得及赋值），另一个 goroutine 就读到了中间状态。

包级变量本身不带同步语义，nil 检查和赋值是两步操作
init() 函数也不行——它在 main() 前执行，无法传参、无法处理初始化失败
手写 sync.Mutex 太重，且容易漏掉二次检查或 defer 解锁

`sync.Once.Do()` 是唯一推荐的初始化入口

sync.Once 内部用原子操作判断 done 标志位，仅当未执行过才加锁并运行函数，执行完自动标记，后续调用直接返回。它轻量、无副作用、官方背书。

初始化函数只能执行一次，无论多少 goroutine 同时调用 GetInstance()
函数内可做任意耗时操作：读配置、连 DB、解析 JSON，都 OK
不要把初始化逻辑拆到多个地方——once.Do() 必须包裹全部初始化步骤

示例：

var (
    instance *Config
    once     sync.Once
)

func GetConfig() *Config {
    once.Do(func() {
        instance = &Config{
            DatabaseURL: os.Getenv("DATABASE_URL"),
            RedisURL:    os.Getenv("REDIS_URL"),
        }
    })
    return instance
}

带错误返回的单例怎么写

真实场景中，初始化常会失败（如 DB 连不上、配置缺失）。错误不能吞掉，也不能让调用方拿到 nil 却不知原因。标准做法是把 error 和实例一起返回，并在 once.Do() 内捕获。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

错误变量必须是包级导出或闭包捕获，否则 Do() 外拿不到
首次失败后，后续调用仍返回同一个 error，不会重试
别在 GetInstance() 外再判 err != nil —— 那会绕过 once 保护

示例：

var (
    instance *DB
    err      error
    once     sync.Once
)

func GetDB() (*DB, error) {
    once.Do(func() {
        instance, err = sql.Open("mysql", dsn)
        if err != nil {
            return
        }
        err = instance.Ping()
    })
    return instance, err
}