Go语言并发编程：使用WaitGroup与通道关闭实现任务同步的最佳实践-Golang-PHP中文网

Go语言并发编程：使用WaitGroup与通道关闭实现任务同步的最佳实践

DDD

发布： 2025-10-07 11:39:33

原创

419人浏览过

Go语言并发编程：使用WaitGroup与通道关闭实现任务同步的最佳实践

本文探讨了在Go语言中，如何优雅地同步多个并发协程的完成状态，特别是当它们向同一个通道发送数据时。通过详细讲解sync.WaitGroup的用法以及配合通道关闭的range循环模式，展示了Go语言处理并发任务的推荐实践，确保数据完整性并简化代码逻辑。

在go语言的并发编程中，一个常见的场景是启动多个协程（goroutines）执行任务，并将结果汇集到一个共享的通道（channel）中。此时，如何准确地判断所有生产者协程都已完成任务，并安全地关闭通道以便消费者能够优雅地读取所有数据，是一个关键问题。

挑战：多生产者与共享通道的同步问题

考虑这样一个场景：我们有N个工作协程，每个协程都会向一个共同的整型通道ch发送N个数据。主协程需要等待所有工作协程完成数据发送后，才能知道何时可以停止从ch中读取数据。

一种直观但非Go惯用的做法是引入一个额外的done通道。每个工作协程完成后向done通道发送一个信号，主协程通过计数done信号的数量来判断所有工作协程是否结束。然而，这种方法存在几个问题：

竞态条件风险： done信号可能在工作协程发送完所有数据但数据尚未被主协程完全读取之前发出，导致主协程提前判断任务完成并停止读取，从而丢失数据。
复杂性： 需要额外的逻辑来处理done信号的计数和清理，增加了代码的复杂性。
非惯用： Go语言提供了更简洁、更安全的机制来处理这类并发同步问题。
无法使用for range： 如果通道没有被关闭，消费者无法使用for i := range ch这种简洁的循环模式来自动感知通道关闭并退出。

为了解决这些问题，Go语言标准库中的sync.WaitGroup提供了一种更优雅、更Go惯用的解决方案。

sync.WaitGroup：协程同步的利器

sync.WaitGroup是Go语言中用于等待一组协程完成的同步原语。它通过一个内部计数器来工作：

立即学习“go语言免费学习笔记（深入）”；

Add(delta int)：将计数器增加delta。通常在启动协程之前调用，表示即将启动delta个协程。
Done()：将计数器减1。通常在协程即将退出时调用，表示一个协程已完成。
Wait()：阻塞当前协程，直到计数器归零。

结合sync.WaitGroup和通道关闭的机制，我们可以实现一个非常健壮且符合Go惯用法的多生产者-单消费者模式。

示例代码：使用sync.WaitGroup和通道关闭

以下是使用sync.WaitGroup重构上述问题的代码示例：

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

package main

import (
    "fmt"
    "sync" // 导入sync包
)

const N = 10

func main() {
    ch := make(chan int, N) // 创建一个带缓冲的整型通道
    var wg sync.WaitGroup   // 声明一个WaitGroup变量

    // 启动N个工作协程
    for i := 0; i < N; i++ {
        wg.Add(1) // 每启动一个协程，计数器加1
        go func(n int) {
            defer wg.Done() // 确保协程退出时（无论正常或异常）计数器减1
            for i := 0; i < N; i++ {
                ch <- n*N + i // 向共享通道发送数据
            }
        }(i)
    }

    // 启动一个独立的协程来等待所有工作协程完成并关闭通道
    go func() {
        wg.Wait()   // 阻塞直到所有工作协程调用Done()，即计数器归零
        close(ch)   // 所有数据发送完毕后，关闭通道
    }()

    // 主协程通过range循环从通道读取数据
    // range循环会在通道关闭且所有缓冲数据被读取后自动退出
    for i := range ch {
        fmt.Println(i)
    }

    fmt.Println("所有数据已处理完毕。")
}

登录后复制

代码解析与最佳实践

sync.WaitGroup的初始化与使用：
- var wg sync.WaitGroup：声明一个WaitGroup变量。它是一个结构体，无需通过make初始化。
- wg.Add(1)：在每次启动工作协程之前调用Add(1)，告知WaitGroup有一个新的任务即将开始。务必在go语句之前调用Add，以避免在Wait被调用时，某个协程还没来得及Add，导致Wait过早返回。
- defer wg.Done()：在每个工作协程内部，使用defer关键字调用wg.Done()。这确保了无论协程是正常完成还是发生panic，Done()都会被调用，从而正确地递减计数器。这是非常关键的，可以防止死锁（主协程永远等待）。
通道的关闭策略：
- go func() { wg.Wait(); close(ch) }()：这是一个非常重要的Go惯用模式。我们启动了一个独立的协程来执行wg.Wait()。这个协程的任务是等待所有生产者协程完成（即wg.Wait()返回），然后负责关闭共享通道ch。
- 为什么需要独立协程来关闭通道？ 如果在主协程中直接调用wg.Wait()，那么主协程会阻塞，无法继续执行for range ch循环。将Wait和close放在一个单独的协程中，使得主协程可以立即开始消费数据，同时由这个辅助协程来管理通道的生命周期。
- 何时关闭通道？ 只有当所有生产者都已完成发送数据时，才能安全地关闭通道。过早关闭可能导致生产者向已关闭的通道发送数据（引发panic），过晚关闭则可能导致消费者永远阻塞。wg.Wait()精确地解决了这个问题。
消费者使用for range：
- for i := range ch { fmt.Println(i) }：这是Go语言中消费通道数据最简洁、最安全的方式。当通道ch被关闭后，for range循环会自动读取通道中所有剩余的缓冲数据，然后优雅地退出循环。这避免了手动检查通道是否关闭和处理ok值的繁琐。