Go语言优雅等待协程完成函数如何写_Go语言Wait通道机制【精讲】-Golang-PHP中文网

waitgroup 的 add 必须在 goroutine 启动前调用，否则 main 协程可能提前退出导致子协程未执行；固定数量时 wg.add(n) 应置于循环外，再启动协程。

go语言优雅等待协程完成函数如何写_go语言wait通道机制【精讲】

程序提前退出、fmt.Println 没输出、子协程“消失”——十有八九是 wg.Add(1) 写在了 go 语句内部或之后。因为 Add 和 go 不是原子操作，main 协程可能已执行完 wg.Wait()，而协程还没来得及注册自己。

正确顺序只有一种：先确定数量，再启动协程。

固定数量（如启动 5 个 worker）：wg.Add(5) 放在循环外，然后 for i := 0; i
动态数量（如从 channel 拉任务）：for task := range tasks { wg.Add(1); go process(task, &wg) } ——Add(1) 必须在 go 前，且不能放进 goroutine 里
Add 传负数会 panic，别手抖写成 wg.Add(-1)

很多人把 defer wg.Done() 写在 if 分支里、error 处理后、甚至 recover 里面，结果一 return 或 panic 就漏调 —— wg.Wait() 会永远卡住。

最稳写法就是：goroutine 入口第一行就是 defer wg.Done()，后面不管怎么分支、提前 return、还是 panic，它都保证执行。

✅ 正确：

go func() {
    defer wg.Done()
    if err != nil {
        return // defer 仍会执行
    }
    // ...
}()

❌ 错误：

go func() {
    if err != nil {
        return // wg.Done() 根本没注册
    }
    defer wg.Done()
}()

sync.WaitGroup 不是“重置型对象”。一旦 wg.Wait() 返回，计数器归零；此时再调 wg.Add(1) 是未定义行为 —— Go 1.21+ 直接 panic。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

这意味着：

不是所有“等完成”的场景都适合 sync.WaitGroup。它只回答一个问题：“它们做完没？”，不关心结果、不支持超时、无法取消。

当你需要：

最容易被忽略的一点：WaitGroup 的计数器是“纯信号”，它不感知协程是否 panic、是否卡死、是否逻辑出错 —— 它只认 Done() 调用次数。所以务必确保每个路径都走到 defer wg.Done()，否则就是静默死锁。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！

Go语言优雅等待协程完成函数如何写_Go语言Wait通道机制【精讲】