Go Academy · 课时

sync.WaitGroup

Q: 「sync.WaitGroup」这节课中我会学到什么？

等待一组 Goroutine 完成 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

等待一组 Goroutine 完成

sync.WaitGroup 是 CoddyKit 上的免费 Go Academy 课时。这是第 2 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。

用途

sync.WaitGroup 会等待一组协程完成。主协程调用 Add 设置计数，每个协程在完成时调用 Done，而 Wait 会阻塞，直到计数变为零。

基本用法

在启动每个协程之前调用 Add；在每个协程末尾调用 Done（通过 defer）；启动所有协程后调用 Wait。

var wg sync.WaitGroup
for _, item := range items {
    wg.Add(1)
    go func(v Item) {
        defer wg.Done()
        process(v)
    }(item)
}
wg.Wait()

必须在协程启动前调用 Add

在 go func() 之前调用 wg.Add(1)，绝不要在协程内部调用。否则，Wait 可能会在协程为自己登记之前就返回。

常见错误：捕获循环变量

将循环变量作为参数传递给协程函数，而不是通过闭包传递，以避免所有协程共享同一个变量。

for _, v := range items {
    wg.Add(1)
    go func(item Item) { // correct: copy
        defer wg.Done()
        process(item)
    }(v)
}

重新使用 WaitGroup

Wait 返回后可以重新使用 WaitGroup，但前提是之前所有的 Done 调用都已返回。存在尚未完成的 Done 调用时，不要同时重新使用它。

使用 WaitGroup 处理结果

WaitGroup 不会收集结果——请将它与通道或切片（配合互斥锁）结合使用，以收集协程的输出。

results := make([]Result, len(items))
for i, item := range items {
    wg.Add(1)
    go func(idx int, v Item) {
        defer wg.Done()
        results[idx] = process(v)
    }(i, item)
}
wg.Wait()

使用批量计数调用 Add

您可以在循环前将总数传递给一次 Add 调用，这比每个协程调用一次 Add 略高效。

wg.Add(len(items))
for _, item := range items {
    go func(v Item) { defer wg.Done(); process(v) }(item)
}

不要复制 WaitGroup

与 Mutex 一样，WaitGroup 首次使用后不得复制。请通过指针传递，或将其嵌入一个通过指针传递的结构体中。

WaitGroup 与 errgroup

golang.org/x/sync/errgroup 封装了 WaitGroup，并增加了错误传播功能。当任一协程失败都应停止其他协程时，优先使用 errgroup。

与上下文结合使用

使用 errgroup.WithContext，同时获得 WaitGroup 语义和一个会在首次出错时取消的上下文，从而干净地停止所有协程。

g, ctx := errgroup.WithContext(context.Background())
g.Go(func() error { return doWork(ctx) })
if err := g.Wait(); err != nil { log.Fatal(err) }

零值即可使用

sync.WaitGroup 的零值即可使用——无需构造函数。只需声明它，然后调用 Add。

快速检查

如果在协程内部调用 wg.Add(1)，而不是在启动协程之前调用，会发生什么？

回顾：sync.WaitGroup

要点：

在启动协程前调用 Add；在协程内部通过 defer 调用 Done
Wait 会阻塞，直到计数变为零
绝不要复制；绝不要在协程内部调用 Add
使用 errgroup 传播错误

常见问题解答

「sync.WaitGroup」课时是免费的吗？

是的 — 「sync.WaitGroup」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。

「sync.WaitGroup」这节课中我会学到什么？

等待一组 Goroutine 完成你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Go Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 2 节课，共 4 节。

「sync.WaitGroup」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Go Academy 课中编写并运行代码吗？

能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Go Academy