如何使用Golang实现单例模式_使用Singleton Pattern创建唯一对象

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 仅出现一次,且 c1c2 指向同一地址。

为什么不用 init() 或全局变量直接初始化?

直接赋值(如 instance := &Config{...})虽简单,但属于“饿汉式”,会在包加载时立即创建——可能浪费资源,或依赖未就绪的环境(如配置未读取)。而 sync.Once 实现的是“懒汉式”,首次调用时才初始化,更灵活可控。同时它天然并发安全,无需手动加锁。

进阶:支持带参数的单例(如依赖注入)

若需初始化时传参(例如从配置文件读取),可将初始化逻辑封装为工厂函数,并在 GetInstance 中调用:

  • 定义一个初始化函数(如 newConfigFromYaml(path string)
  • once.Do 中调用该函数并赋值给 instance
  • 首次调用 GetInstance("config.yaml") 时加载,后续调用忽略参数(因只执行一次)

注意:参数仅对首次生效,后续调用无法改变实例状态——这符合单例语义。

基本上就这些。Go 的单例不复杂但容易忽略并发安全,sync.Once 是最推荐的方式,干净、高效、无副作用。