Go语言singleton如何创建_Go语言单例设计模式方法【模板】-Golang-PHP中文网

sync.once 是 go 中实现线程安全单例最可靠的方式，因其确保初始化函数仅执行一次且支持按需延迟初始化、错误处理和参数传递，而 init() 无法满足这些需求。

go语言singleton如何创建_go语言单例设计模式方法【模板】

sync.Once 是 Go 语言中创建线程安全单例最可靠的方式，其他方式要么不安全、要么有隐藏缺陷。别用 if instance == nil 加锁就以为万事大吉——漏掉双重检查或锁粒度不对，照样会创建多个实例。

为什么不用 init() 做单例？

因为 init() 在包加载时执行，无法按需延迟初始化，也不支持传参或错误处理。一旦在 init() 里读配置、连数据库或启动服务，失败会导致整个程序启动崩溃，且无法重试或降级。
常见误用：init() 中调用 sql.Open() 或 http.ListenAndServe()——这些操作本该由显式的 GetXXX() 函数控制生命周期。

`sync.Once` 必须是包级变量或结构体字段

它不能放在函数内部，否则每次调用都新建一个 sync.Once 实例，完全失去“只执行一次”的意义。
正确写法：

var once sync.Once
var instance *Service

func GetService() *Service {
    once.Do(func() {
        instance = &Service{...}
    })
    return instance
}

错误写法（局部变量）：

Go语言（Golang）1.26.0

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

下载

func GetService() *Service {
    var once sync.Once // ❌ 每次调用都是新 once
    once.Do(...)
    ...
}

sync.Once 是值类型，但必须持久存在；传参或赋值给局部变量会复制，失效
如果单例属于某个客户端结构体，推荐把 once sync.Once 作为字段嵌入，但方法接收者必须是指针：func (c *Client) Do() {...}
初始化函数若 panic，sync.Once 会永久记住失败状态，后续调用仍 panic——需自行兜底，比如用返回值 + error 判断

带参数的单例怎么写？

全局变量硬编码参数（如 var db *sql.DB + func InitDB(dsn string)）破坏封装、不可测试、无法复用。
正确做法是把构造逻辑收进函数，单例控制交给 sync.Once：

type Config struct{ DSN string; Timeout int }
var configOnce sync.Once
var configInstance *Config

func NewConfig(cfg Config) *Config {
    configOnce.Do(func() {
        configInstance = &cfg // 或深拷贝、校验等
    })
    return configInstance
}

func GetConfig() *Config {
    return configInstance
}