深入理解Go语言的sync.WaitGroup:超越屏障的通用事件同步机制

陌丽君_6530

陌丽君_6530

2025-12-02

601人浏览

原创

深入理解Go语言的sync.WaitGroup:超越屏障的通用事件同步机制

本文深入探讨go语言标准库中的`sync.waitgroup`同步原语。我们将解析其核心功能,并将其与并发编程中的屏障(barrier)和计数信号量(counting semaphore)进行比较,阐明`waitgroup`作为一种更通用的事件等待机制的本质。文章将通过示例代码展示其在等待多个goroutine完成或追踪任务进度等场景下的灵活应用,旨在帮助开发者准确理解并高效利用`waitgroup`进行并发控制。

在Go语言的并发编程模型中,sync.WaitGroup是一个至关重要的同步原语,它允许程序等待一组goroutine完成执行。理解WaitGroup的真正用途及其与传统并发概念(如屏障和信号量)的区别,对于编写健壮且高效的并发代码至关重要。

sync.WaitGroup的核心机制

sync.WaitGroup内部维护一个计数器,其核心功能由以下三个方法组成:

  • Add(delta int):将计数器增加delta。通常在启动新的goroutine之前调用,表示需要等待的事件数量。如果delta为负数,则减少计数器。
  • Done():减少计数器1。通常在goroutine完成其工作时调用。它等价于Add(-1)。
  • Wait():阻塞当前goroutine,直到计数器归零。这意味着所有通过Add增加的事件都已通过Done完成。

sync.WaitGroup与屏障(Barrier)

在并发编程中,屏障(Barrier)是一种同步机制,它允许一组线程(在Go中是goroutine)在继续执行之前,等待所有成员都到达某个特定点。

sync.WaitGroup确实可以被用作屏障。当您需要等待多个goroutine都完成其初始化或达到某个中间状态时,WaitGroup能够很好地实现这一功能。例如,主goroutine可以启动多个工作goroutine,并通过WaitGroup.Add(N)设置计数器,然后每个工作goroutine在完成任务后调用WaitGroup.Done(),主goroutine则通过WaitGroup.Wait()等待所有工作goroutine完成。

然而,需要注意的是,在Go语言中,通道(channel)也是实现屏障的一种非常惯用的方式,尤其是在需要更精细控制或传递数据时。

尽管WaitGroup可以作为屏障使用,但这并非其功能的全部。将WaitGroup仅仅视为屏障会限制您对其更广泛用途的理解。

sync.WaitGroup与计数信号量(Counting Semaphore)

计数信号量是另一种并发原语,它允许N个线程同时访问一个共享资源。它通过一个计数器来限制对资源的访问,当计数器大于零时,线程可以获取信号量并访问资源(计数器减一);当计数器为零时,线程必须等待。

Go语言(Golang)1.26.0
Go语言(Golang)1.26.0

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

下载

sync.WaitGroup与计数信号量有本质区别。WaitGroup的主要目的是等待一系列事件的完成,它不涉及对共享资源的访问控制。它没有“获取”或“释放”资源的语义,也不限制并发访问的数量。虽然它们都涉及一个计数器,但WaitGroup的计数器是用来追踪“待完成事件”的数量,而信号量的计数器是用来追踪“可用资源或许可”的数量。因此,将sync.WaitGroup视为屏障与计数信号量的结合体,但没有共享资源的概念,是不完全准确的。WaitGroup根本不具备信号量那种管理共享资源访问的能力。

sync.WaitGroup的真正目的与典型应用场景

sync.WaitGroup的真正目的是简单地等待您预期会发生的事件数量完成。这可以包括:

  1. 等待多个Goroutine完成: 这是最常见的用法。主goroutine启动多个子goroutine执行并行任务,然后等待所有子goroutine完成。
  2. 追踪任务完成进度: 您可以启动M个goroutine来处理N个任务。WaitGroup可以用来追踪N个任务的完成情况,而不是M个goroutine的完成情况。例如,每个任务开始时调用Add(1),任务完成后调用Done(),无论哪个goroutine执行了它。
  3. 通用事件同步: 任何您需要等待一系列异步事件全部完成的场景,都可以使用WaitGroup。

示例代码:等待多个Goroutine完成

以下是一个典型的sync.WaitGroup使用示例,演示了如何等待多个goroutine执行完毕。

package main

import (
    "fmt"
    "sync"
    "time"
)
// 模拟一个需要一些时间来完成的任务
func worker(id int, wg *sync.WaitGroup) {
    defer wg.Done() // 确保在goroutine退出时调用Done()
    fmt.Printf("Worker %d: 正在启动...\n", id)
    time.Sleep(time.Duration(id) * time.Second) // 模拟工作
    fmt.Printf("Worker %d: 完成任务。\n", id)
}

func main() {
    var wg sync.WaitGroup // 声明一个WaitGroup
    numWorkers := 3

    fmt.Println("主程序: 启动工作goroutine...")

    for i := 1; i <p><strong>代码解析:</strong></p><ol>
<li>在main函数中,我们声明了一个sync.WaitGroup变量wg。</li>
<li>通过wg.Add(1)在每次启动worker goroutine之前将计数器增加1。这告诉WaitGroup我们期望有一个新的事件需要等待。</li>
<li>worker函数接受一个*sync.WaitGroup指针。在其开始时,使用defer wg.Done()确保无论worker如何退出(正常完成或panic),计数器都会被减少。</li>
<li>main函数最后调用wg.Wait(),这将阻塞main goroutine,直到wg的内部计数器变为0。只有当所有worker goroutine都调用了Done()之后,main函数才会继续执行。</li>
</ol><h3>注意事项与最佳实践</h3>
  • Add必须在Wait之前调用: 务必在调用Wait()之前调用Add()。如果在Wait()之后调用Add(),或者在Add()和Wait()之间,且WaitGroup的计数器已经归零,可能会导致死锁或未定义的行为。理想情况下,Add应该在启动goroutine之前完成。
  • 传递WaitGroup的指针: 当将WaitGroup传递给函数或goroutine时,必须传递其指针(*sync.WaitGroup),因为WaitGroup是一个结构体,按值传递会创建副本,导致计数器无法正确同步。
  • 确保Done()被调用: 每个通过Add()增加的事件都必须最终调用Done()。使用defer wg.Done()是一个非常安全和推荐的做法,以防止因函数提前返回或panic导致Done()未被调用而引起的死锁。
  • 避免过度使用或滥用: WaitGroup适用于等待一组明确数量的事件。对于更复杂的同步模式,如生产者-消费者模型、速率限制或超时控制,可能需要结合使用通道、context包或其他同步原语。
  • 错误处理: 如果goroutine中发生panic,且没有被recover,defer wg.Done()仍然会执行。但如果panic导致程序崩溃,WaitGroup可能无法完成其同步目的。在关键的goroutine中考虑使用recover来捕获panic并进行适当处理。

总结

sync.WaitGroup是Go语言中一个强大而灵活的并发同步工具。它通过一个简单的计数器机制,使得等待多个异步事件完成变得直观和高效。虽然它在特定场景下可以模拟屏障的行为,但其核心价值在于作为一种通用的事件等待机制,能够等待任意数量的预期事件。准确理解其工作原理和适用场景,并遵循最佳实践,将有助于您编写出更健壮、可维护的Go并发程序。

golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2025.06.09

5514

18

golang结构体方法
golang结构体方法

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

2025.07.04

5691

25

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.02

7619

3

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.08.29

3605

6

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

2025.08.29

4768

10

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

2025.08.29

3165

10

C++ 智能指针与现代内存管理
C++ 智能指针与现代内存管理

深入讲解 C++ 现代内存管理的核心工具——智能指针,涵盖 unique_ptr 独占所有权语义、shared_ptr 引用计数机制与循环引用问题、weak_ptr 弱引用的应用场景、make_unique/make_shared 工厂函数的性能优势、自定义删除器的编写、RAII 资源管理思想的实践,以及从裸指针迁移到智能指针的重构策略,帮助开发者编写安全无泄漏的现代 C++ 代码。

2026.04.23

399

31

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

2023.08.10

4918

6

Go中Type关键字的用法
Go中Type关键字的用法

Go中Type关键字的用法有定义新的类型别名或者创建新的结构体类型。本专题为大家提供Go相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.06

3509

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Go-Zero HTTP服务开发指南
Go-Zero HTTP服务开发指南

共0课时 | 0人学习

Go-Zero goctl安装与使用手册
Go-Zero goctl安装与使用手册

共0课时 | 0人学习

Go-Zero框架快速开始指南
Go-Zero框架快速开始指南

共0课时 | 0人学习