如何在 Go 中利用 sync.Once 实现单例模式初始化-Golang-PHP中文网

sync.Once.Do 通过 uint32 原子变量配合 atomic.CompareAndSwapUint32 和互斥锁双重保障，确保初始化函数仅执行一次；一旦开始执行（含 panic），后续调用直接返回，不重试。

sync.Once.Do 为什么能保证只执行一次

sync.once.do 内部用一个 uint32 原子变量标记是否已执行，配合 atomic.compareandswapuint32 和互斥锁双重保障。它不关心传入函数是否 panic —— 一旦执行开始（哪怕中途 panic），后续调用都会直接返回，不再重试。

这意味着：如果初始化函数里有未处理的 panic，单例对象可能处于半初始化状态，且无法再次触发初始化。这是最容易被忽略的风险点。

初始化函数必须自行处理所有错误，不能依赖外层重试
不要在 Do 中调用可能阻塞过久的操作（如网络请求未设超时），否则会卡住所有后续调用
sync.Once 不提供获取执行结果的机制，需额外用变量承载初始化产出

典型单例结构：指针 + once.Do + init 函数

Go 没有类，单例本质是包级变量 + 初始化控制。常见写法是定义一个导出的指针变量和一个非导出的 initFunc，再用 sync.Once.Do 包裹。

var (
    instance *Config
    once     sync.Once
)

func GetConfig() *Config {
    once.Do(func() {
        instance = &Config{
            Timeout: 30,
            Host:    os.Getenv("API_HOST"),
        }
        // 这里可以加载文件、连接 DB 等
        if err := instance.loadFromYAML("/etc/app/config.yaml"); err != nil {
            // 必须处理错误，比如 log.Fatal 或设置默认值
            log.Printf("failed to load config: %v", err)
            instance.Timeout = 10 // fallback
        }
    })
    return instance
}

注意：instance 是包级变量，GetConfig 是唯一出口。别把 once 放进 struct 里 —— 那就不是全局单例了。