使用 sync.Once 实现单例,确保全局唯一实例:定义私有变量和 once,通过 GetInstance() 调用 once.Do() 初始化,支持线程安全延迟创建;需传参时应在初始化阶段显式调用 Init() 注入配置,避免在 init 或 if 判断中创建以防并发问题;推荐依赖注入替代全局单例以提升可测试性。

在 Go 语言中实现单例模式,核心是确保一个结构体(或类型)在整个程序生命周期中只存在唯一实例,并提供全局、线程安全的访问方式。Go 没有类和构造函数的概念,但可以通过包级变量 + sync.Once 实现简洁、高效、并发安全的单例。
使用 sync.Once 保证初始化仅一次
sync.Once 是 Go 标准库提供的工具,能确保某个函数在多协程环境下只执行一次。这是实现线程安全单例最推荐的方式。
- 定义一个私有全局变量(如
instance *Singleton) - 定义一个私有
sync.Once变量 - 提供公有方法(如
GetInstance()),内部用once.Do()包裹初始化逻辑
示例:
package singleton
import "sync"
type Singleton struct {
Name string
}
var (
instance *Singleton
once sync.Once
)
func GetInstance() *Singleton {
once.Do(func() {
instance = &Singleton{Name: "default"}
})
return instance
}
支持传参的单例(延迟初始化 + 配置注入)
若单例需要依赖外部参数(如配置、连接字符串),可将初始化逻辑封装为工厂函数,配合闭包或额外初始化方法实现。
立即学习“go语言免费学习笔记(深入)”;
动态WEB网站中的PHP和MySQL详细反映实际程序的需求,仔细地探讨外部数据的验证(例如信用卡卡号的格式)、用户登录以及如何使用模板建立网页的标准外观。动态WEB网站中的PHP和MySQL的内容不仅仅是这些。书中还提到如何串联JavaScript与PHP让用户操作时更快、更方便。还有正确处理用户输入错误的方法,让网站看起来更专业。另外还引入大量来自PEAR外挂函数库的强大功能,对常用的、强大的包
- 不直接在
GetInstance()中硬编码参数 - 提供
Init(config Config)方法,首次调用时设置实例;后续调用忽略 - 或改用带参数的
GetSingleton(name string),但需注意:严格意义上这已不是“单例”,而是对象池变体
更稳妥的做法是:在 main() 或初始化阶段显式调用一次 Init(),再通过无参 GetInstance() 获取。
避免常见陷阱
- 不要用 init() 函数创建单例:虽然能保证只执行一次,但无法控制初始化时机(早于 main),也无法传参或处理错误
-
不要依赖包级变量 + if 判断:如
if instance == nil { instance = &Singleton{} }—— 在并发下不安全 -
慎用反射或 sync.Mutex 手动加锁:性能低,且容易出错;
sync.Once更轻量、语义清晰 - 导出的字段或方法要明确职责:单例本身应尽量无状态,或状态可控;避免隐式共享导致难以测试
单例的替代思路:依赖注入更推荐
Go 社区普遍认为,过度使用全局单例会增加耦合、降低可测试性。更现代的做法是:
- 在
main()中创建所需对象(如 DB、Logger、Config) - 通过构造函数或方法参数显式传入依赖
- 配合 Wire(Google)、Dig(Uber)等 DI 框架自动管理生命周期
单例适合真正全局、无状态、不可变或强一致性的组件(如日志器、指标收集器),而非业务服务对象。
基本上就这些。用 sync.Once + 包级变量是最简单、最安全、最 Go 的单例写法,不复杂但容易忽略并发细节。









