waitgroup.add(1) 必须在 go 语句前调用，且与 defer wg.done() 成对出现在同一 goroutine 中；channel 由生产者在所有发送完成后、wg.wait() 前关闭，消费者用 for range 读取。
WaitGroup.Add() 被放在 goroutine 内部导致计数错乱
程序卡在 wg.Wait() 不返回、CPU 占用极低，基本就是这个原因。根本不是 WaitGroup 本身有问题，而是 wg.Add(1) 被写在了 go func() { ... }() 里面，或者放在了 channel 发送之后、但 goroutine 还没真正启动的位置。
实操建议：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
wg.Add(1)必须出现在go语句之前，且和defer wg.Done()成对出现在同一 goroutine 函数体内 - 避免在循环外一次性调用
wg.Add(len(tasks))，除非你能确保每个 task 都会触发 goroutine 启动并最终执行Done() - 加日志或用
runtime.NumGoroutine()确认所有预期 goroutine 确实已创建，而不是“以为起了，其实被 channel 阻塞或 panic 拦住了”
channel 关闭时机错误引发消费者等待闭环
常见现象是部分任务漏处理，或整个同步流程 hang 在 wg.Wait() 之后——因为消费者 goroutine 还在等 channel 数据，而生产者已经退出，channel 却没关；或者 channel 关得太早，某些 goroutine 还没开始读就结束了。
实操建议：
- channel 必须由生产者关闭，且关闭动作必须放在所有发送操作完成后、
wg.Wait()之前 - 消费者端统一用
for val := range ch，不要手动val, ok := + 判断 <code>ok后再调wg.Done()，否则最后一次迭代容易遗漏 - 把
defer wg.Done()放在消费者函数最顶部，而不是range循环结束之后
WaitGroup 值传递导致计数失效
现象是 wg.Wait() 永远不返回，runtime.NumGoroutine() 显示大量 goroutine 已结束，但主 goroutine 仍在阻塞——说明 Add() 和 Done() 操作的不是同一个实例。
实操建议：
- 所有函数参数、闭包捕获、方法接收器，一律传
*sync.WaitGroup，例如func worker(wg *sync.WaitGroup, ch - 检查 for-range 启动 goroutine 的闭包：别写
go func() { wg.Done() }()，要显式传参go func(wg *sync.WaitGroup) { defer wg.Done() }(wg) - 编译时加
-race参数，这类复制问题会被竞态检测器直接报出
镜像同步任务中真正的并发瓶颈不在 WaitGroup
WaitGroup 死锁只是表象，背后往往是更底层的资源竞争：比如大量 goroutine 同时往 /tmp 写同名 ZIP 文件，触发系统级文件冲突；或 HTTP client 复用不当，连接池耗尽后阻塞在 dial；又或者 metadata 解析阶段 SAT 求解器因约束过宽陷入无限回溯，CPU 拉满但 WaitGroup 计数早已归零。
排查优先级顺序：
- 先确认是否真卡在 WaitGroup ——
kill -SIGQUIT $(pidof php)看 goroutine stack，若大量 goroutine 停在sync.runtime_SemacquireMutex或runtime.gopark，才是 WaitGroup 问题；若停在os.OpenFile、net/http.(*Transport).roundTrip或composer\src\Solver\Solver.php，就得换方向 - Linux 下用
lsof -p $(pidof php) | wc -l查打开文件数，超上限会静默失败 - Windows 下重点看 %TEMP% 目录 inode（实际是 MFT 条目）是否耗尽，
dir /s %TEMP%可能卡住，改用 PowerShellGet-ChildItem $env:TEMP -Recurse | Measure-Object
