Go语言中结构体实例化与单例模式的结合是实际开发中非常常见的需求，单例模式的核心目标是保证一个结构体在整个程序运行周期内只存在一个实例，同时提供全局访问该实例的入口，在配置管理、连接池初始化等场景下都有广泛应用。
Go语言结构体基础实例化方式
在了解单例模式之前，先回顾Go语言结构体的常见实例化方式，这些是基础操作，也是后续单例实现的基础。
值实例化
直接声明结构体变量，会使用该结构体字段的零值进行初始化，适合字段都有合理零值或者后续会逐个赋值的场景。
package main
import "fmt"
type Config struct {
Port int
Path string
}
func main() {
// 值实例化，Port为0，Path为空字符串
var config Config
fmt.Println(config)
}
指针实例化
使用new关键字或者取地址操作，会返回结构体的指针实例，new返回的是指针类型，初始化时同样使用零值。
package main
import "fmt"
type Config struct {
Port int
Path string
}
func main() {
// new实例化，返回*Config类型
config1 := new(Config)
// 取地址实例化，同样返回*Config类型
config2 := &Config{}
fmt.Printf("%T %Tn", config1, config2)
}
带初始值的实例化
在实例化时直接给结构体字段赋值，适合需要初始默认非零点值的场景，字段顺序需要和结构体定义一致，或者使用字段名赋值避免顺序错误。
package main
import "fmt"
type Config struct {
Port int
Path string
}
func main() {
// 按顺序赋值初始化
config1 := Config{8080, "/data"}
// 按字段名赋值，顺序可以打乱，更推荐这种写法
config2 := Config{Path: "/tmp", Port: 9090}
fmt.Println(config1, config2)
}
单例模式的核心需求
单例模式需要满足三个核心条件：第一是结构体实例全局唯一，不能重复创建；第二是实例需要延迟初始化，也就是第一次被访问的时候才创建，避免程序启动时就初始化不必要的资源；第三是线程安全，在并发场景下多个goroutine同时访问时，不会出现创建多个实例的问题。
Go语言结构体单例的惯用实现方式
基于互斥锁的实现
这是最基础的单例实现思路，通过一个全局变量保存实例，一个互斥锁保证并发安全，每次获取实例的时候先判断实例是否已经存在，不存在则加锁创建。
package main
import (
"fmt"
"sync"
)
type Database struct {
ConnStr string
}
var (
dbInstance *Database
dbMutex sync.Mutex
)
// GetDatabase 获取单例实例
func GetDatabase() *Database {
// 先判断实例是否存在，存在则直接返回，避免每次都加锁影响性能
if dbInstance != nil {
return dbInstance
}
// 加锁保证并发安全
dbMutex.Lock()
defer dbMutex.Unlock()
// 再次判断，防止多个goroutine同时通过第一次判断，加锁后重复创建
if dbInstance == nil {
dbInstance = &Database{
ConnStr: "127.0.0.1:3306",
}
}
return dbInstance
}
func main() {
db1 := GetDatabase()
db2 := GetDatabase()
fmt.Println(db1 == db2) // 输出true，两个实例是同一个
}
这种实现方式的优点是逻辑清晰，容易理解，缺点是双重检查的写法容易遗漏第二次判断，导致并发场景下创建多个实例，而且代码相对繁琐。
基于sync.Once的惯用实现
Go语言标准库中的sync.Once是保证函数只执行一次的原语，非常适合用来实现单例模式，这也是Go语言中更推荐、更惯用的单例实现方式。
package main
import (
"fmt"
"sync"
)
type Config struct {
Port int
Path string
}
var (
configInstance *Config
configOnce sync.Once
)
// GetConfig 获取单例配置实例
func GetConfig() *Config {
// Do方法保证传入的函数在整个程序生命周期内只执行一次
configOnce.Do(func() {
configInstance = &Config{
Port: 8080,
Path: "/app/data",
}
})
return configInstance
}
func main() {
var wg sync.WaitGroup
// 启动10个goroutine并发获取实例
for i := 0; i < 10; i++ {
wg.Add(1)
go func() {
defer wg.Done()
cfg := GetConfig()
fmt.Printf("实例地址：%pn", cfg)
}()
}
wg.Wait()
}
这种实现方式的优点是代码简洁，不需要自己处理双重检查和锁的逻辑，sync.Once内部已经实现了高效的并发控制，避免了重复创建实例的问题，是Go语言中实现单例模式的首选方式。
不同实现方式的对比
下面通过表格对比两种常见单例实现方式的特点：
| 实现方式 | 代码复杂度 | 并发安全性 | 推荐程度 |
|---|---|---|---|
| 互斥锁+双重检查 | 较高，需要手动处理锁和二次判断 | 正确实现后安全 | 一般，适合理解原理 |
| sync.Once | 低，仅需几行代码 | 标准库保证安全 | 高，Go语言惯用写法 |
单例实现的注意事项
- 单例实例的初始化逻辑如果比较复杂，或者可能返回错误，需要在
sync.Once的回调函数中处理错误，避免错误导致实例初始化失败但后续调用仍然返回空实例的问题。 - 单例结构体如果包含需要释放的资源，比如数据库连接、文件句柄等，需要额外实现关闭方法，在程序退出的时候主动调用释放资源，避免资源泄漏。
- 不要在单例的初始化逻辑中依赖其他单例，避免出现循环依赖的问题，导致程序启动失败。
Go语言中单例模式的核心是利用语言提供的并发原语保证实例唯一，优先选择sync.Once实现，既符合语言习惯，也能减少出错概率。