Golang单例模式如何实现 sync.Once线程安全方案-Golang-PHP中文网

Golang单例模式如何实现 sync.Once线程安全方案

P粉602998670

发布： 2025-08-28 12:52:01

原创

754人浏览过

Go语言中单例模式需确保结构体仅初始化一次且线程安全；2. 推荐使用sync.Once保证唯一性和并发安全；3. 示例中GetInstance通过once.Do确保初始化逻辑仅执行一次；4. 多goroutine测试验证了实例唯一与线程安全；5. sync.Once底层通过互斥锁和标志位实现，确保内存同步与原子性。

golang单例模式如何实现 sync.once线程安全方案

在Go语言中，单例模式的实现需要确保在整个程序生命周期中某个结构体仅被初始化一次，并且在多协程环境下线程安全。最推荐的方式是使用 sync.Once 来保证初始化的唯一性和并发安全。

单例模式核心问题

单例的关键在于：实例只能创建一次，即使多个 goroutine 同时访问，也不能重复创建。常见的错误做法是使用全局变量加 if 判断，但这在并发场景下会出问题。

使用 sync.Once 实现线程安全单例

sync.Once 能确保某个函数在整个程序运行期间只执行一次，非常适合用于单例初始化。

示例代码：

package main

import (
    "fmt"
    "sync"
)

type Singleton struct {
    data string
}

var instance *Singleton
var once sync.Once

func GetInstance() *Singleton {
    once.Do(func() {
        instance = &Singleton{
            data: "I am the only instance",
        }
        fmt.Println("Singleton instance created")
    })
    return instance
}

登录后复制

在这个实现中：

立即学习“go语言免费学习笔记（深入）”；

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

查看详情

GetInstance() 是获取单例实例的唯一入口
once.Do() 内的初始化逻辑只会执行一次，无论多少个 goroutine 同时调用
后续调用直接返回已创建的 instance

测试并发安全性

可以启动多个 goroutine 来验证是否真的只初始化一次：

func main() {
    var wg sync.WaitGroup
    for i := 0; i < 10; i++ {
        wg.Add(1)
        go func() {
            defer wg.Done()
            obj := GetInstance()
            fmt.Printf("Got instance: %p, data: %s\n", obj, obj.data)
        }()
    }
    wg.Wait()
}

登录后复制

输出结果中，“Singleton instance created” 只会打印一次，所有 goroutine 获取的是同一个实例地址，证明线程安全且唯一。