Go语言中，sync.WaitGroup引发死锁的常见原因是什么？

本文共计995个文字，预计阅读时间需要4分钟。

请提供您希望修改的原文，我将根据您的要求进行改写。

WaitGroup 值传递导致 Done() 无效

这是最隐蔽也最常踩的坑：把 sync.waitgroup 当作普通结构体按值传入 goroutine，比如 go downloadfile(url, wg)。go 会复制整个结构体，而 sync.waitgroup 内部包含 sync.mutex 和计数器字段，副本间的互斥锁和计数器完全独立。子 goroutine 调用 wg.done() 只是减少副本计数，main 中的原始 wg.wait() 永远等不到计数归零。

• 运行 go vet 会直接报错：passes sync.WaitGroup by value
• 必须改为指针传递：go downloadFile(url, &wg)，且函数签名要声明为 func downloadFile(url string, wg *sync.WaitGroup)
• IDE（如 GoLand、VS Code + gopls）通常会在参数位置标黄并提示 “contains sync.Locker”

defer wg.Done() 放错位置，提前 return 导致未执行

defer wg.Done() 如果写在函数中间或末尾，一旦前面有 return err 或 panic，它根本不会触发。