GolangWaitGroup管理goroutine实战指南

IT行业相对于一般传统行业，发展更新速度更快，一旦停止了学习，很快就会被行业所淘汰。所以我们需要踏踏实实的不断学习，精进自己的技术，尤其是初学者。今天golang学习网给大家整理了《Golang WaitGroup管理多个goroutine实践》，聊聊，我们一起来看看吧！

答案：sync.WaitGroup用于等待多个goroutine完成，通过Add、Done、Wait方法实现同步。典型应用场景为并行处理批量任务，如并发请求用户数据，需注意避免在goroutine内调用Add、确保Add与Done配对、防止复制使用WaitGroup。结合context可实现超时控制，避免无限阻塞，提升程序健壮性。

在Go语言开发中，经常需要并发执行多个任务并等待它们全部完成。这时 sync.WaitGroup 就成了最常用的同步原语之一。它能有效管理多个goroutine的生命周期，确保主协程在所有子协程执行完毕后再退出。

WaitGroup 基本原理与核心方法

WaitGroup 本质是一个计数器，用来等待一组操作完成。它有三个关键方法：

• Add(delta int)：增加或减少计数器值。通常在启动goroutine前调用 Add(1)。
• Done()：将计数器减1，一般放在goroutine末尾，可配合 defer 使用。
• Wait()：阻塞当前协程，直到计数器归零。

使用时需注意：Add 必须在 Wait 调用前执行，否则可能引发 panic。常见模式是在主协程中 Add，每个子协程结束时调用 Done，主协程通过 Wait 阻塞等待。

实际项目中的典型应用场景

在Web服务中，常需并行处理多个外部API请求或数据库查询。例如批量获取用户信息：

var wg sync.WaitGroup
results := make([]UserData, len(userIDs))
for i, uid := range userIDs {
    wg.Add(1)
    go func(index int, userID string) {
        defer wg.Done()
        data, err := fetchUserData(userID)
        if err != nil {
            log.Printf("获取用户 %s 失败: %v", userID, err)
            return
        }
        results[index] = data
    }(i, uid)
}
wg.Wait()
// 此时 results 已填充完成

这种写法显著提升响应速度。注意闭包中传参要避免变量共享问题，应将循环变量作为参数传入goroutine。

避免常见错误和性能陷阱

WaitGroup 虽简单，但误用容易导致死锁或panic：

• 不要在goroutine内部调用 Add，可能导致Wait提前结束。应在外部先 Add 再启动协程。
• 确保每个 Add 都有对应的 Done，漏掉会导致永久阻塞。
• 不可复制已使用的 WaitGroup，会导致数据竞争。
• 在HTTP处理器等高并发场景中，避免频繁创建WaitGroup带来的开销，可结合 context 控制超时。

若任务数量不确定或动态变化，考虑搭配 channel 或 errgroup 等更高级控制结构。

结合 context 实现超时控制

生产环境中，不能无限等待。可结合 context 实现安全超时：

ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
defer cancel()

done := make(chan struct{})
go func() {
    var wg sync.WaitGroup
    for _, task := range tasks {
        wg.Add(1)
        go func(t Task) {
            defer wg.Done()
            process(t)
        }(task)
    }
    wg.Wait()
    close(done)
}()

select {
case 

这种方式既保证了并发效率，又具备容错能力。

基本上就这些。WaitGroup 是Go并发编程的基石工具，掌握其正确用法对构建稳定服务至关重要。不复杂但容易忽略细节。

好了，本文到此结束，带大家了解了《GolangWaitGroup管理goroutine实战指南》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！