Golang中once.Do用法及单例实现方法
时间:2025-06-26 23:45:18 322浏览 收藏
小伙伴们有没有觉得学习Golang很有意思?有意思就对了!今天就给大家带来《Golang中once.Do的作用是确保某个函数只执行一次,常用于初始化资源或单例模式。使用once.Do实现单例模式的步骤如下:定义一个sync.Once变量。在需要初始化的函数中调用once.Do(func() { ... })。通过一个全局变量保存单例实例。示例代码:package main import ( "fmt" "sync" ) type Singleton struct { data string } var once sync.Once var instance *Singleton func GetInstance() *Singleton { once.Do(func() { instance = &Singleton{data: "Singleton Data"} }) return instance } func main() { s1 := GetInstance() s2 := GetInstance() fmt.Println(s1 == s2) // 输出 true fmt.Println(s1.data) // 输出 Singleton Data }此方法确保GetInstance函数在并发环境下只会初始化一次单例实例。》,以下内容将会涉及到,若是在学习中对其中部分知识点有疑问,或许看了本文就能帮到你!
once.Do 在 Golang 中用于确保某个函数只被执行一次,解决了并发初始化导致的竞态条件问题。它通过 sync.Once 类型实现线程安全的单次执行机制,适用于全局资源初始化、单例模式等场景。与锁相比,once.Do 仅在首次调用时阻塞,后续调用直接返回,提高了性能。使用时需注意:1. 初始化函数不能有返回值;2. 函数内部避免使用锁或递归调用,防止死锁;3. 若函数 panic,后续调用将不再执行该函数,可能导致错误隐藏。
once.Do
在 Golang 中用于确保某个函数只被执行一次,无论多少个 goroutine 同时调用它。这对于初始化全局资源、配置单例模式等场景非常有用。

解决方案

sync.Once
类型提供了一种只执行一次操作的机制。它只有一个方法:Do(f func())
。当你调用 once.Do(f)
时,如果 f
之前没有被执行过,那么 f
就会被执行,否则 f
会被忽略。
package main import ( "fmt" "sync" ) var ( once sync.Once instance *Singleton ) type Singleton struct { data string } func GetInstance() *Singleton { once.Do(func() { instance = &Singleton{data: "Initial data"} fmt.Println("Singleton created") }) return instance } func main() { s1 := GetInstance() s2 := GetInstance() fmt.Printf("Singleton 1: %p, data: %s\n", s1, s1.data) fmt.Printf("Singleton 2: %p, data: %s\n", s2, s2.data) s1.data = "Updated data" fmt.Printf("Singleton 1: %p, data: %s\n", s1, s1.data) fmt.Printf("Singleton 2: %p, data: %s\n", s2, s2.data) }
在这个例子中,GetInstance
函数使用 once.Do
来确保 Singleton
实例只被创建一次。即使多个 goroutine 同时调用 GetInstance
,也只有一个 goroutine 会执行 instance = &Singleton{data: "Initial data"}
。

为什么需要 once.Do
?它解决了什么问题?
在并发编程中,如果不加控制地执行某些初始化操作,可能会导致竞态条件。例如,多个 goroutine 同时尝试初始化同一个全局变量,可能会导致数据损坏或程序崩溃。once.Do
提供了一种线程安全的方式来确保初始化操作只执行一次,避免了竞态条件。想象一下,如果没有 once.Do
,你可能需要使用锁来保护初始化操作,这会增加代码的复杂性,并且容易出错。once.Do
提供了一种更简洁、更可靠的解决方案。
once.Do
和锁有什么区别?何时应该使用 once.Do
?
虽然锁也可以用来保护初始化操作,但 once.Do
在某些情况下更有效率。锁会阻塞所有尝试访问共享资源的 goroutine,直到锁被释放。而 once.Do
只会在第一次调用时阻塞,后续的调用会直接返回,避免了不必要的阻塞。
你应该在以下情况下使用 once.Do
:
- 你需要确保某个函数只被执行一次。
- 这个函数用于初始化全局资源或配置单例模式。
- 你希望避免竞态条件和数据损坏。
- 你希望提高程序的性能,避免不必要的阻塞。
例如,假设你有一个全局配置对象,需要在程序启动时加载配置文件。你可以使用 once.Do
来确保配置文件只被加载一次。
var ( config *Config loadConfigOnce sync.Once ) type Config struct { // 配置项 } func LoadConfig() *Config { loadConfigOnce.Do(func() { // 从文件中加载配置 config = &Config{} // 实际的加载逻辑 fmt.Println("Config loaded") }) return config }
使用 once.Do
时需要注意哪些问题?是否存在死锁的风险?
使用 once.Do
时,需要注意以下几点:
once.Do
接受的函数不能有返回值。如果你的初始化函数需要返回一个值,你需要使用其他方式来存储这个值。once.Do
内部使用了互斥锁,因此如果once.Do
接受的函数本身也使用了锁,可能会导致死锁。- 如果
once.Do
接受的函数 panic,那么once.Do
会认为这个函数已经执行过了,后续的调用会直接返回,而不会再次执行这个函数。这可能会导致程序出现意想不到的错误。
关于死锁的风险,如果 once.Do
接受的函数内部调用了自身,或者调用了其他使用了相同锁的函数,就可能会导致死锁。例如:
var ( once sync.Once ) func initFunc() { once.Do(func() { fmt.Println("Initializing...") initFunc() // 递归调用,导致死锁 }) } func main() { initFunc() }
在这个例子中,initFunc
内部递归调用了自身,导致死锁。为了避免死锁,你需要仔细检查 once.Do
接受的函数,确保它不会调用自身或者其他使用了相同锁的函数。
理论要掌握,实操不能落!以上关于《Golang中once.Do用法及单例实现方法》的详细介绍,大家都掌握了吧!如果想要继续提升自己的能力,那么就来关注golang学习网公众号吧!
-
505 收藏
-
502 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
366 收藏
-
310 收藏
-
484 收藏
-
240 收藏
-
402 收藏
-
291 收藏
-
402 收藏
-
377 收藏
-
436 收藏
-
174 收藏
-
195 收藏
-
350 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 542次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 508次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 497次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 484次学习