sync.WaitGroup通过Add、Done、Wait三步实现goroutine等待:启动前Add(1),结束时defer Done(),主协程在所有go启动后调用Wait()阻塞至计数归零;须传指针、避免闭包捕获错误、配合context超时使用。

用 sync.WaitGroup 等待所有 goroutine 结束
Go 主协程不会自动等待子 goroutine,main 函数一返回,整个进程立刻退出,不管后台还有多少 goroutine 在跑。最直接、最常用的方式是用 sync.WaitGroup 控制生命周期。
关键不是“监听”,而是“计数 + 阻塞”:启动前 Add(1),结束时 Done(),主协程调用 Wait() 卡住直到计数归零。
-
Add(1)必须在go语句之前调用,否则可能漏计数 -
Done()强烈建议放在defer里,确保 panic 时也能减计数 -
Wait()必须在所有go启动之后、且不能在 goroutine 内部调用(会死锁) - 不要把
WaitGroup实例传进闭包而不取地址——变量捕获错误会导致Done()操作到副本上,计数永远不归零
为什么不能用 channel 简单替代 WaitGroup
有人试图用无缓冲 channel 实现“每个 goroutine 发一个信号,主协程收 n 次”来等结束。这可行,但没必要,还容易出错:
- channel 是为通信设计的,WaitGroup 才是专为“等待完成”优化的原语,更轻量、语义更清晰
- 用 channel 要手动管理容量、关闭逻辑;若忘记关闭或未消费完,
Wait()类似行为需自己写循环 + 超时,冗余 - 当 goroutine 可能提前失败(如网络超时),WaitGroup 本身不提供中断能力,但也不会掩盖错误——它只管“是否调了 Done”,错误处理得靠你自己的逻辑
WaitGroup 和 context.WithCancel 配合使用才真正健壮
单纯等完成不够——如果某个 goroutine 卡死或永远不返回,Wait() 就永远阻塞。生产环境必须加超时或取消机制。
立即学习“go语言免费学习笔记(深入)”;
正确姿势是把 context.Context 传给每个 goroutine,内部用 select 监听 ctx.Done(),并在收到取消信号时主动清理并调用 Done():
- 主协程调用
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second) - 每个 goroutine 启动时接收
ctx,并在耗时操作中定期检查ctx.Err() - 无论成功、失败或被取消,最后都必须调用
wg.Done(),否则Wait()永远不返回 - 主协程在
defer cancel()后调用wg.Wait(),避免资源泄漏
goroutine 启动后 panic 会导致 WaitGroup 计数不一致吗
会,但只发生在 Add(1) 已执行、Done() 还没执行就 panic 的情况下。不过这不是 WaitGroup 的缺陷,而是使用方式问题。
解决方法非常明确:
- 始终把
wg.Done()放在函数第一行的defer中,这样即使后续 panic,Done()仍会执行 - 不要在循环里写
go func() { wg.Done() }()这种闭包——wg变量会被捕获成同一个地址,但循环变量i或item容易出错;应显式传参:go func(wg *sync.WaitGroup, item string) { defer wg.Done(); ... }(wg, item) - WaitGroup 实例本身不能复制(比如作为结构体字段被赋值),否则内部计数器失效;务必传指针
WaitGroup 不是黑盒,它只是个带原子计数器的结构体。真正容易被忽略的是:它不负责错误传播、不处理超时、不感知上下文——这些都得靠你组合其他机制补全。别把它当万能锁,而要当成并发控制链条里精准的一环。


















