在Go语言的并发编程中，Goroutine是轻量级线程，由Go运行时管理调度，但若主函数提前退出，所有未执行完的Goroutine会被直接终止，这是很多初学者遇到Goroutine未执行的核心原因。
主函数提前退出的典型场景
我们先看一个最基础的示例，直观感受主函数提前退出带来的影响：
package main
import "fmt"
func printMsg() {
fmt.Println("Goroutine执行完成")
}
func main() {
go printMsg()
fmt.Println("主函数执行完成")
}
运行上述代码时，大概率只会输出主函数执行完成，Goroutine执行完成很少出现。这是因为主函数启动Goroutine后没有等待其执行，直接执行到末尾退出，Go运行时会终止所有还在运行的Goroutine，导致printMsg函数没有机会执行。
解决主函数提前退出的常用方案
1. 使用time.Sleep简单等待
最简单的方式是在主函数末尾添加休眠，给Goroutine足够的执行时间：
package main
import (
"fmt"
"time"
)
func printMsg() {
fmt.Println("Goroutine执行完成")
}
func main() {
go printMsg()
fmt.Println("主函数执行完成")
time.Sleep(1 * time.Second) // 休眠1秒等待Goroutine执行
}
这种方式仅适合简单测试，实际生产中无法准确预估Goroutine的执行耗时，休眠时间太短可能还是无法等待Goroutine执行，太长则会浪费资源。
2. 使用sync.WaitGroup等待所有Goroutine完成
sync.WaitGroup是Go标准库提供的等待一组Goroutine完成的工具，适合多个Goroutine的场景：
package main
import (
"fmt"
"sync"
)
var wg sync.WaitGroup
func printMsg() {
defer wg.Done() // Goroutine执行完成后计数器减1
fmt.Println("Goroutine执行完成")
}
func main() {
wg.Add(1) // 注册一个需要等待的Goroutine
go printMsg()
fmt.Println("主函数等待Goroutine完成")
wg.Wait() // 阻塞直到所有注册的Goroutine都执行完成
fmt.Println("所有Goroutine执行完毕，主函数退出")
}
使用时需要注意，wg.Add的调用要在启动Goroutine之前，避免Goroutine先执行完导致计数器错误；每个Goroutine中必须通过defer wg.Done()确保计数器正确减少。
3. 使用channel通信等待
通道是Go中Goroutine之间通信的主要方式，也可以通过通道实现等待Goroutine完成的效果：
package main
import "fmt"
func printMsg(ch chan struct{}) {
fmt.Println("Goroutine执行完成")
ch <- struct{}{} // 向通道发送信号，表示执行完成
}
func main() {
ch := make(chan struct{})
go printMsg(ch)
fmt.Println("主函数等待Goroutine完成")
<-ch // 阻塞等待通道接收信号
fmt.Println("收到Goroutine完成信号，主函数退出")
}
这种方式适合需要获取Goroutine执行结果的场景，若不需要结果也可以使用无缓冲通道实现同步等待。
4. 使用runtime.Gosched让出CPU
runtime.Gosched会让当前goroutine让出CPU时间片，让其他goroutine有机会执行，不过这种方式不能保证一定等待Goroutine完成，仅适合简单调试：
package main
import (
"fmt"
"runtime"
)
func printMsg() {
fmt.Println("Goroutine执行完成")
}
func main() {
go printMsg()
fmt.Println("主函数让出CPU")
runtime.Gosched() // 让出CPU时间片
fmt.Println("主函数退出")
}
不同方案的适用场景对比
| 方案 | 适用场景 | 优缺点 |
|---|---|---|
| time.Sleep | 简单测试、临时调试 | 实现简单，但无法准确控制等待时间，不适合生产环境 |
| sync.WaitGroup | 多个Goroutine需要统一等待完成 | 标准库支持，使用灵活，是生产环境最常用的方案 |
| channel通信 | 需要获取Goroutine执行结果或传递数据 | 符合Go的通信共享内存理念，适合有数据交互的场景 |
| runtime.Gosched | 简单调试、主动让出CPU | 不能保证等待完成，仅适合临时使用 |
注意事项
- 不要在Goroutine中调用
os.Exit，否则会直接终止整个程序，不管其他Goroutine是否执行完成。 - 使用sync.WaitGroup时，计数器的增减要匹配，避免出现死锁或者计数器错误的情况。
- 通道等待时要注意通道的关闭时机，避免向已关闭的通道发送数据导致panic。
主函数提前退出是Goroutine未执行的最常见原因，理解Go的Goroutine调度机制，选择合适的等待方案，就能有效避免这类问题，写出更稳定的Go并发程序。
Goroutine主函数提前退出go_waitgroupgo_channelgo_runtime修改时间：2026-07-03 12:24:30