详细介绍Golang中用于并发等待的组函数（sync.WaitGroup）-Golang-PHP中文网

waitgroup 是计数器+信号量组合，需手动 add/ done/ wait；常见误用包括 add 位置错误、未 add 就 done 导致 panic；不可复用除非严格串行完成；不支持超时，需配合 context 或 select 实现。

详细介绍golang中用于并发等待的组函数（sync.waitgroup）

WaitGroup 的基本用法和常见误用

WaitGroup 不是“等待所有 goroutine 结束”的自动魔法，它只是计数器 + 信号量的组合。你必须手动调用 Add 增加计数、Done 减少计数，最后用 Wait 阻塞直到归零。

最常踩的坑是：在 goroutine 外部调用 Done，或者在未调用 Add 的情况下调用 Done —— 这会直接 panic：panic: sync: negative WaitGroup counter。

Add 必须在启动 goroutine 之前（或至少在 Done 之前）调用，且参数不能为负
Done 等价于 Add(-1)，只能在 goroutine 内部安全调用
Wait 可被多次调用，但一旦计数归零，后续 Wait 立即返回，不会重置计数
不要把 WaitGroup 当作锁用；它不保证 goroutine 执行顺序，也不保护共享数据

为什么不能在 goroutine 启动后才 Add？

因为 go func() { ... }() 是异步的，调度不可控。如果在 go 语句之后才调用 Add(1)，主线程可能已执行到 Wait 并提前返回，而 goroutine 还没来得及运行 Done —— 导致程序提前退出，goroutine 被强制终止。

正确做法是：先 wg.Add(1)，再 go func() { defer wg.Done(); ... }()。

// ✅ 正确
wg.Add(1)
go func() {
    defer wg.Done()
    // do work
}()

// ❌ 危险：Add 在 go 后，竞态风险高
go func() {
    // do work
    wg.Done()
}()
wg.Add(1) // 这里 Add 已晚，Wait 可能早已返回

WaitGroup 和 context.WithTimeout 组合使用时要注意什么？

WaitGroup 本身不支持超时。如果想实现“等最多 5 秒，超时就放弃”，不能只靠 Wait，必须配合 context 或 channel select。

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

典型错误是：在 Wait 上阻塞，同时另起 goroutine 发送 cancel —— 这无法中断 Wait，因为 Wait 没有上下文感知能力。

用 select + done channel 实现带超时的等待（Wait 自身不返回 channel）
可封装一个辅助函数：WaitWithTimeout(wg *sync.WaitGroup, timeout time.Duration) bool，内部用 sync.Once 避免重复 close
注意：超时后 WaitGroup 计数仍为 0（如果所有 goroutine 已完成），或仍大于 0（部分未完成）—— 你无法“取消”正在运行的 goroutine，只能选择忽略它们