GolangWaitGroup并发等待使用详解

Go语言中的WaitGroup是sync包中用于主goroutine等待其他goroutine完成的核心同步原语，但极易因Add与Done调用不匹配（如Add放在go内部、漏掉defer Done、值传递WaitGroup等）导致程序提前退出、死锁或panic；它仅解决“是否全部完成”这一单一问题，不支持超时、条件等待或数据传递，正确用法的关键在于：Add必须在goroutine启动前调用且总数匹配、统一使用defer wg.Done()确保异常和多出口下计数准确、始终以指针方式传递WaitGroup——掌握这些细节，才能真正驾驭并发等待的精确性与可靠性。

WaitGroup 是 Go 标准库 sync 包里最常用、也最容易用错的并发同步工具之一。它不负责传递数据，只解决「主 goroutine 等待其他 goroutine 执行完毕」这个单一问题——但一旦 Add 和 Done 调用不匹配，就会 panic 或死锁。

WaitGroup 的 Add 必须在 goroutine 启动前调用

这是最常踩的坑：把 Add(1) 放在 go func() 内部，导致主 goroutine 调用 Wait() 时计数器仍是 0，直接返回，后续 goroutine 还没执行完程序就退出了。

正确做法是：

• Add 必须在 go 语句之前调用，确保计数器已更新
• 如果启动 N 个 goroutine，就要提前 Add(N)；不能靠循环里每个 goroutine 自己 Add(1)
• 计数器初始值为 0，Add 可传负数（但通常只用 Done() 来减）

示例：

var wg sync.WaitGroup
for i := 0; i 

<h3>Done 和 Add(-1) 的行为完全等价，但别混用</h3>
<p><code>Done()</code> 本质就是 <code>Add(-1)</code>，二者可互换。但混用会降低可读性，且容易漏掉 <code>Done</code> ——尤其在有多个 return 分支的函数中。</p>
<p>建议统一用 <code>defer wg.Done()</code>，确保无论从哪个出口退出，计数都能减少。</p>

• 如果函数里有多个 error return，不用每个都写 wg.Done()
• 避免在循环体中直接调用 Done() 而忘记 defer，容易因 panic 跳过
• 不要在同一个 WaitGroup 上重复调用 Done() 超过 Add 总数，否则 panic: "sync: negative WaitGroup counter"

WaitGroup 不能被复制，必须传指针

sync.WaitGroup 是包含 mutex 和原子计数器的结构体，按值传递会复制一份独立状态，导致主 goroutine 等的不是同一组 goroutine。

典型错误写法：

func spawn(wg sync.WaitGroup) { // ❌ 值传递，wg 是副本
    wg.Add(1)
    go func() { wg.Done() }()
}
// 调用后 wg.Wait() 永远阻塞

正确方式只有两种：

• 定义为包级变量（不推荐，破坏封装）
• 函数参数用 *sync.WaitGroup（✅ 推荐）

例如：func worker(wg *sync.WaitGroup, job string)，调用时传 &wg。

WaitGroup 不适合做“条件等待”或“带超时的等待”

WaitGroup.Wait() 是纯阻塞调用，没有上下文支持，也没有超时机制。如果你需要：

• 等待最多 5 秒 → 得配合 time.AfterFunc 或 select + time.After
• 等待某个条件成立（如 channel 关闭、变量变化）→ 应该用 sync.Cond 或 channel
• 取消正在等待的 Wait → WaitGroup 本身不支持，得结合 context.Context 自行控制 goroutine 生命周期

换句话说：WaitGroup 只回答一个问题——“那些我 Add 过的 goroutine，都 Done 了吗？” 它不管它们干了什么、结果如何、有没有卡住。

真正难的不是调用 Wait()，而是确保每次 Add 都有对应且仅一次的 Done，尤其是在错误路径、recover、或者提前 return 的场景下。漏一个，程序就 hang；多一个，直接 panic。

到这里，我们也就讲完了《GolangWaitGroup并发等待使用详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！