Go sync.WaitGroup 值传递导致死锁怎么办？

Question

仓乃文 · Accepted Answer

sync.WaitGroup 包含内部计数器，必须传指针使用。值传递会拷贝计数器，goroutine 内部调用 Done() 递减的是副本，原始 WaitGroup 的计数器永远不会归零，Wait() 永远阻塞。

错误写法：
```go
func worker(wg sync.WaitGroup) { // 值传递，拷贝了 WaitGroup
    defer wg.Done() // 递减的是副本，原始 wg 不受影响
}

func main() {
    var wg sync.WaitGroup
    wg.Add(1)
    go worker(wg) // 传值
    wg.Wait()      // 永远阻塞，计数器不会归零
}
```

正确写法：
```go
func worker(wg *sync.WaitGroup) { // 指针传递
    defer wg.Done()
}

func main() {
    var wg sync.WaitGroup
    wg.Add(1)
    go worker(&wg) // 传指针
    wg.Wait()       // 正常退出
}
```

补充说明：
- go vet 能检测 WaitGroup 值传递问题
- 同理，sync.Mutex、sync.Once、sync.Cond 都不能值传递
- 结构体包含 WaitGroup 时，结构体本身也要传指针
- WaitGroup.Add() 要在 goroutine 启动前调用，不能在 goroutine 内部 Add
- WaitGroup 不能被复制：go vet 的 copylocks 检查能发现