0

0

如何用Golang实现单例模式 详解sync.Once的线程安全实践

P粉602998670

P粉602998670

发布时间:2025-08-12 14:23:01

|

310人浏览过

|

来源于php中文网

原创

sync.once通过确保初始化函数只执行一次来实现线程安全的单例。1. 使用包级变量保存单例实例;2. 通过getinstance方法调用once.do进行初始化;3. 初始化逻辑仅在首次调用时执行,后续调用直接返回已有实例。应用场景包括配置管理、日志记录器、数据库连接池和缓存服务。注意事项:do方法仅接受无参函数,避免长时间阻塞,不可复用once对象,多个初始化步骤需合并到一个函数中。

如何用Golang实现单例模式 详解sync.Once的线程安全实践

单例模式在很多场景下非常实用,尤其是在需要全局唯一实例的情况下。Golang中虽然没有类的概念,但通过结构体和包级变量可以轻松实现单例。而说到线程安全的单例初始化,sync.Once就成了最常用、也最推荐的方式。

如何用Golang实现单例模式 详解sync.Once的线程安全实践

什么是sync.Once?

sync.Once
是 Go 标准库提供的一个工具类型,用于确保某个函数只执行一次。它的典型应用场景就是单例的初始化。无论多少个 goroutine 同时调用,Once 都能保证那个初始化函数只会被执行一次。

如何用Golang实现单例模式 详解sync.Once的线程安全实践

基本结构是这样的:

立即学习go语言免费学习笔记(深入)”;

var once sync.Once
once.Do(func() {
    // 初始化逻辑
})

这个特性非常适合用来做单例初始化,因为我们可以把创建对象的逻辑放在 Do 里面,不管有多少并发请求进来,都只会创建一次。

如何用Golang实现单例模式 详解sync.Once的线程安全实践

如何用sync.Once实现单例?

假设我们要实现一个数据库连接池的单例,结构大概是这样:

type Database struct {
    conn string
}

var instance *Database
var once sync.Once

func GetInstance() *Database {
    once.Do(func() {
        instance = &Database{conn: "MySQL connection"}
    })
    return instance
}

这里有几个关键点:

  • instance
    是一个包级别的变量,保存了单例对象。
  • 每次调用
    GetInstance()
    ,都会进入 Once 的 Do 方法,但只有第一次会真正执行初始化。
  • 因为 Once 是线程安全的,所以不用担心并发问题。

这种写法简洁又高效,是 Go 中最常见的单例实现方式之一。

HTTPie AI
HTTPie AI

AI API开发工具

下载

单例模式的应用场景有哪些?

单例不是为了炫技,而是解决实际问题。以下是一些常见的使用场景:

  • 配置管理:程序运行期间只需要一份配置信息,比如读取 config.yaml。
  • 日志记录器:整个项目共用一个 logger 实例,方便统一输出格式和级别。
  • 数据库连接池:避免重复建立连接,提升性能。
  • 缓存服务:比如 Redis 客户端的封装,通常只需要一个客户端实例。

这些场景都需要“全局唯一”并且“延迟加载”,而 sync.Once 能很好地满足这两个条件。


注意事项和常见误区

使用 sync.Once 看似简单,但有些细节容易被忽略:

  • Do 方法只能接受无参数的函数,如果你需要传参,得在函数内部处理。
  • 不要在 Do 中执行长时间阻塞操作,会影响其他 goroutine。
  • Once 只保证初始化一次,不负责后续状态同步。也就是说,如果单例本身有状态变化,还需要额外加锁或使用原子操作。
  • Once 不可复用。一旦 Do 执行完毕,再调用 Do 是不会起作用的。

举个例子,下面这段代码可能有问题:

once.Do(connectToDB)
once.Do(setupTables) // 这行不会执行!

因为 Once 只执行一次,第二次调用 Do 就直接跳过了。如果你有两个初始化步骤,最好合并到一个函数里。


总结一下

用 Golang 实现线程安全的单例,最推荐的方式就是结合包级变量和 sync.Once。它不仅写法简单,而且天然支持并发控制。只要注意一些边界情况和使用限制,就能写出既高效又稳定的代码。

基本上就这些,不需要太复杂,但也别忽略了细节。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

174

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

224

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

335

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

206

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

388

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

193

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

188

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

191

2025.06.17

小游戏4399大全
小游戏4399大全

4399小游戏免费秒玩大全来了!无需下载、即点即玩,涵盖动作、冒险、益智、射击、体育、双人等全品类热门小游戏。经典如《黄金矿工》《森林冰火人》《狂扁小朋友》一应俱全,每日更新最新H5游戏,支持电脑与手机跨端畅玩。访问4399小游戏中心,重温童年回忆,畅享轻松娱乐时光!官方入口安全绿色,无插件、无广告干扰,打开即玩,快乐秒达!

30

2025.12.31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
golang socket 编程
golang socket 编程

共2课时 | 0.1万人学习

nginx浅谈
nginx浅谈

共15课时 | 0.8万人学习

golang和swoole核心底层分析
golang和swoole核心底层分析

共3课时 | 0.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号