在go语言中，当主函数启动goroutine后，若不进行适当的同步，主函数可能会在其并发协程完成之前退出，导致goroutine中的输出语句无法执行或显示。本文将深入探讨这一常见问题，并通过对比不推荐的`time.sleep`方案与推荐的`sync.waitgroup`机制，详细阐述如何正确地等待goroutine完成，确保并发任务的可靠执行与结果输出。
引言：Go Goroutine的并发特性与常见陷阱
Go语言以其内置的并发原语Goroutine和Channel而闻名，它们使得编写并发程序变得简单高效。Goroutine是轻量级的线程，由Go运行时管理，可以并发执行函数。然而，初学者在使用Goroutine时常会遇到一个看似奇怪的现象：启动了Goroutine，但它们似乎没有执行任何操作，尤其是在尝试打印输出时。这通常不是Goroutine本身的问题，而是Go程序的主协程（main goroutine）过早退出的结果。
问题复现：为何Goroutine没有输出？
考虑以下Go程序代码：
package main
import "fmt"
func f(msg string) {
fmt.Println(msg)
return
}
func main() {
go f("goroutine")
go func(msg string) {
fmt.Println(msg)
return
}("going")
return
}当你运行这段代码时，你会发现程序没有任何输出。如果移除go关键字，让f("goroutine")和匿名函数直接在主协程中执行，那么“goroutine”和“going”将会被正常打印出来。这表明问题出在并发执行上。
原因分析：主协程的生命周期
Go程序的主协程是程序的入口点，当main函数执行完毕后，主协程就会退出，并终止整个程序。这意味着，如果主协程在它启动的任何其他Goroutine完成之前退出，那么这些Goroutine将不会有机会完成它们的执行，包括其中的打印操作。在上面的示例中，main函数启动了两个Goroutine后，并没有等待它们完成就直接返回了，导致程序立即终止，两个子Goroutine来不及打印任何内容。
立即学习“go语言免费学习笔记（深入）”；
不推荐的解决方案：time.Sleep的局限性
一种直观但非常不推荐的解决方案是让主协程暂停一段时间，以期望Goroutine能在这段时间内完成工作。
package main
import (
"fmt"
"time" // 引入time包
)
func f(msg string) {
fmt.Println(msg)
}
func main() {
go f("goroutine")
go func(msg string) {
fmt.Println(msg)
}("going")
time.Sleep(2 * time.Second) // 暂停2秒
}虽然这段代码可能会打印出“goroutine”和“going”，但这种方法存在严重缺陷：
- 不确定性：你无法确定2秒（或其他任意时长）是否足够让所有Goroutine完成。如果Goroutine需要更长的时间，程序仍然会提前终止。
- 效率低下：如果Goroutine很快完成，主协程却仍然要等待2秒，这会造成不必要的延迟和资源浪费。
- 不良实践：这种硬编码的等待时间使得程序脆弱且难以维护，不符合并发编程的最佳实践。
因此，time.Sleep只适用于非常简单的测试或演示场景，在生产环境中应避免使用。
推荐的解决方案：sync.WaitGroup详解
Go标准库中的sync.WaitGroup提供了一种更健壮、更灵活的方式来等待一组Goroutine完成。它是一个计数器，可以实现以下功能：
- Add(delta int): 增加WaitGroup的计数器。通常在启动Goroutine之前调用，表示有多少个Goroutine需要等待。
- Done(): 减少WaitGroup的计数器。每个Goroutine在完成其工作时调用此方法。
- Wait(): 阻塞当前Goroutine（通常是主协程），直到WaitGroup的计数器变为零。
下面是使用sync.WaitGroup改进后的代码：
package main
import (
"fmt"
"sync" // 引入sync包
)
// f函数现在接受一个指向sync.WaitGroup的指针
func f(msg string, wg *sync.WaitGroup) {
defer wg.Done() // 确保Goroutine完成时调用Done()
fmt.Println(msg)
}
func main() {
var wg sync.WaitGroup // 声明一个WaitGroup变量
// 启动第一个Goroutine
wg.Add(1) // 计数器加1，表示有一个Goroutine需要等待
go f("goroutine", &wg)
// 启动第二个Goroutine（匿名函数）
wg.Add(1) // 计数器再加1，表示又有一个Goroutine需要等待
go func(msg string) {
defer wg.Done() // 确保Goroutine完成时调用Done()
fmt.Println(msg)
}("going")
wg.Wait() // 阻塞主协程，直到计数器归零
fmt.Println("所有Goroutine已完成。") // 只有所有Goroutine完成后才会打印
}在这段代码中：
- 我们声明了一个sync.WaitGroup变量wg。
- 在启动每个Goroutine之前，我们调用wg.Add(1)来增加计数器，告诉WaitGroup我们正在启动一个需要等待的Goroutine。
- 在每个Goroutine的函数体中，我们使用defer wg.Done()。defer语句确保无论Goroutine如何退出（正常完成或发生panic），wg.Done()都会被调用，从而减少计数器。
- 最后，在main函数中，我们调用wg.Wait()。这会使主协程阻塞，直到wg的内部计数器变为零（即所有通过Add增加的Goroutine都调用了Done）。一旦计数器归零，Wait()就会解除阻塞，main函数可以继续执行或退出。
通过这种方式，我们确保了主协程会一直等待，直到所有它关心的Goroutine都完成了它们的任务，从而保证了所有的输出都能被打印出来。
总结与最佳实践
当你在Go语言中使用Goroutine执行并发任务，并且需要确保这些任务在程序退出前完成时，sync.WaitGroup是首选的同步机制。
- 明确任务数量：使用wg.Add()在启动Goroutine之前明确需要等待的任务数量。
- 任务完成通知：在每个Goroutine完成其工作时，务必调用wg.Done()。推荐使用defer wg.Done()以确保即使在函数提前返回或发生错误时也能正确通知WaitGroup。
- 等待所有任务：在需要等待所有Goroutine完成的地方（通常是主协程），调用wg.Wait()。
掌握sync.WaitGroup是编写健壮、高效Go并发程序的关键一步，它能帮助你避免因主协程过早退出而导致的并发任务执行不完整问题。
