wg.Add(1)必须在goroutine启动前调用,否则Done可能在Add前执行导致计数器为负而panic;正确顺序是先Add(1)再go func(){defer Done()},且需避免闭包捕获循环变量。

WaitGroup 必须在启动 goroutine 前调用 Add,否则 wg.Wait() 会永远阻塞或 panic。
为什么 wg.Add(1) 放在 go 语句后面会导致 panic?
常见错误写法是先启动 goroutine,再调用 wg.Add(1)。此时 wg.Wait() 可能提前返回(计数器为 0),或更糟——goroutine 执行 wg.Done() 时计数器已为 0,触发 panic: sync: negative WaitGroup counter。
根本原因是:Add 和 Done 不是原子配对操作,WaitGroup 依赖计数器严格非负。必须确保每个 Done 都有对应且已执行的 Add。
- ✅ 正确顺序:先
wg.Add(len(tasks)),再批量启动 goroutine - ✅ 动态任务数也适用:先遍历收集任务,再
wg.Add(n),最后统一go - ❌ 禁止在循环里写
wg.Add(1); go func() { ... }()——Add和go之间存在竞态窗口
闭包中引用循环变量,所有 goroutine 都打印同一个值怎么办?
典型现象:for i := 0; i 3。这是因为所有 goroutine 共享变量 i 的内存地址,等它们真正执行时,循环早已结束,i 值固定为终值。
立即学习“go语言免费学习笔记(深入)”;
修复只需让每个 goroutine 拥有独立副本:
- 传参方式:
go func(id int) { fmt.Println(id) }(i) - 重绑定方式:
i := i; go func() { fmt.Println(i) }() - 注意:如果 goroutine 内部还要调用
wg.Done(),记得把*sync.WaitGroup也作为参数传入,或用闭包捕获指针
sync.WaitGroup 被复制后 panic: “WaitGroup is reused before previous Wait has returned”
这个 panic 表明你把 sync.WaitGroup 当作值传递了,比如函数参数写成 func worker(wg sync.WaitGroup) 或 goroutine 中直接传 wg。WaitGroup 内含 mutex 和计数器,禁止拷贝。
所有操作(Add、Done、Wait)必须作用于同一内存地址上的实例:
- ✅ 始终用指针:函数参数类型为
*sync.WaitGroup - ✅ 启动 goroutine 时传
&wg,而不是wg - ✅ 全局或包级变量也建议声明为
*sync.WaitGroup,避免意外值拷贝
WaitGroup 不处理 panic,goroutine 崩溃后主协程可能卡死
sync.WaitGroup 只负责计数和阻塞,它完全不感知内部 panic。如果某个 goroutine 在调用 wg.Done() 前 panic,计数器不会减少,wg.Wait() 将无限等待。
这不是设计缺陷,而是职责分离:同步归 WaitGroup,错误兜底归你。
- 务必在 goroutine 内部用
defer func() { if r := recover(); r != nil { log.Printf("panic: %v", r) } }() - 或者更推荐:把业务逻辑封装进带 error 返回的函数,用
if err != nil显式处理失败,再调用wg.Done() - 复杂场景建议配合
context.Context实现超时控制,避免无限等待
最易被忽略的一点:WaitGroup 的生命周期必须覆盖全部 goroutine 的执行期。哪怕只漏掉一次 Done 或多调一次 Done,都会导致不可恢复的阻塞或 panic —— 它不像 channel 那样有缓冲或 select 降级机制,是纯计数型同步原语。


















