sync.WaitGroup 不是同步屏障，Go 标准库中无原生 barrier；它仅通过 Add、Done、Wait 实现单次完成等待，多次阶段同步需主协程控制 Add/Wait 时序，且须避免闭包捕获循环变量导致的逻辑错乱。
sync.WaitGroup 不是同步屏障，Go 标准库中没有叫“同步屏障”的函数。你真正想用的，是 sync.WaitGroup 实现多协程阶段性等待 —— 比如一批 goroutine 执行完第一阶段后集体停住，等全部就位再一起进第二阶段。
这和 MPI 里的 barrier 不同，Go 没有原生 barrier 类型，但可以用 sync.WaitGroup + 额外协调机制模拟出阶段性同步效果。
为什么不能直接用 WaitGroup 做多次 Wait
WaitGroup 的 Wait() 方法只在计数器归零时返回，且一旦返回，计数器就为 0；再次 Add() 是允许的，但必须确保前一次 Wait() 已返回、无其他 goroutine 正在调用 Add() 或 Wait()。常见错误包括：
- 在
Wait()还没返回时，另一个 goroutine 调用Add()→ panic “WaitGroup misuse” - 多个阶段共用同一个
WaitGroup却没重置状态（实际不需要重置，但需严格控制 Add/Wait 时序） - 误以为
WaitGroup支持“唤醒所有等待者后继续计数”，它不支持 —— 它只回答“是否全做完”，不提供阶段信号广播能力
用 sync.WaitGroup 模拟两阶段同步的实操写法
典型场景：10 个 worker goroutine 并行处理数据，每完成一轮计算后，必须等全部就绪，才统一进入下一轮（比如批量提交、校验、或更新共享状态）。关键点不是“等完就结束”，而是“等完再一起动”。
推荐做法：每个阶段独立调用 Add() → 启动 goroutine → Done() → Wait()，靠主 goroutine 控制阶段流转。
- 第一阶段开始前：
wg.Add(10) - 每个 goroutine 内部用
defer wg.Done()或显式调用wg.Done()，确保阶段任务结束即减一 - 主 goroutine 在第一阶段末尾调用
wg.Wait()，阻塞直到 10 个都完成 - 第二阶段开始前，再次
wg.Add(10)（此时wg已回到 0 状态，安全） - 重复上述流程
示例片段（省略业务逻辑）：
var wg sync.WaitGroup for round := 0; round <h3>闭包捕获循环变量导致阶段性同步失效</h3><p>这是阶段性同步中最隐蔽的坑：goroutine 启动时闭包引用了 <code>for</code> 循环变量，结果所有 goroutine 共享同一个值，导致 <code>doWorkStage(round, id)</code> 中的 <code>round</code> 或 <code>id</code> 错乱，某些 goroutine 可能跳过阶段、重复执行、或根本没启动。</p>
- 错误写法：
go func() { ... doWorkStage(round, i) ... }()→i和round是外部变量，会被所有 goroutine 共享 - 正确写法：显式传参，
go func(r, id int) { ... doWorkStage(r, id) ... }(round, i) - 如果阶段数动态变化（比如从 channel 动态读取任务），必须先收集全部任务，再
Add(len(tasks))，不能边收边Add
真正需要 barrier 语义时的替代方案
如果你需要的是“任意 goroutine 到达即等待，全员到齐后一起放行”，sync.WaitGroup 无法满足 —— 它要求主 goroutine 主动调用 Wait()，而 barrier 是去中心化的。
- 可用
sync.Cond+sync.Mutex自建 barrier，但需手动管理计数、广播、唤醒，容易出竞态 - 更稳妥的做法是引入第三方库，如
github.com/uber-go/ratelimit不适用，但golang.org/x/sync/errgroup也不提供 barrier；目前社区主流仍是用WaitGroup分阶段控制，或改用 channel + select 实现“到达即登记，满员即广播” - 一个轻量可行模式：用带缓冲 channel 做登记桶，配合原子计数器 +
sync.Once触发广播，但复杂度陡增，仅当真有跨 goroutine 协调需求时才值得投入
多数所谓“阶段性同步”需求，其实只需要主 goroutine 掌控节奏，WaitGroup 分段 Add/Wait 就够用；强行追求 MPI 风格 barrier，反而让逻辑变脆、调试变难。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
