cmd.Run()卡住不返回是因为它是纯同步阻塞调用，只等待子进程退出，不感知超时或取消信号；正确做法是使用exec.CommandContext配合context.WithTimeout，超时后自动终止子进程并返回context.DeadlineExceeded错误。
cmd.Run() 为什么卡住不返回
因为 cmd.Run() 是纯同步阻塞调用，它只等子进程退出，不感知任何超时或取消信号。哪怕外部命令死循环、网络 hang 住、或 fork 出后台子进程没 wait，Go 主 goroutine 就一直卡在这儿，无法响应 context deadline 或手动中断。
这不是 bug，是设计使然：它本质就是 cmd.Start() + cmd.Wait() 的封装，没做任何上下文集成。
- 别在生产环境直接用
cmd.Run()调用不可信的外部命令（如 curl、ssh、ffmpeg） - 本地测试跑得通 ≠ 部署后安全：Alpine 镜像缺工具、容器网络策略限制、DNS 解析慢，都可能让命令卡死
- 即使加了
time.AfterFunc手动cmd.Process.Kill()，也存在竞态——进程可能刚退出你就发 kill，报os: process already finished
必须用 exec.CommandContext 配合 context.WithTimeout
exec.CommandContext 是 Go 1.7+ 的标准解法，它把 context 生命周期和子进程生命周期绑定，超时后自动发送 SIGKILL（Unix）或调用 TerminateProcess（Windows），无需手写 select 或定时器。
关键点：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 超时错误类型固定为
context.DeadlineExceeded，不是 syscall 错误，可直接用errors.Is(err, context.DeadlineExceeded)判断 - 必须在创建命令时传入 context，
exec.Command("sleep", "10")后再赋值cmd.Context = ctx无效 - 子进程被杀后，Go 运行时会自动回收句柄，不用额外
Wait()，但若用了Start()就必须配对Wait()
示例：
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
cmd := exec.CommandContext(ctx, "sh", "-c", "sleep 10; echo done")
out, err := cmd.Output()
if err != nil {
if errors.Is(err, context.DeadlineExceeded) {
log.Println("command timed out")
} else {
log.Printf("command failed: %v", err)
}
return
}
log.Printf("output: %s", out)
shell -c 场景下子进程残留怎么办
当你用 exec.Command("sh", "-c", "ping -c 4 example.com | grep ttl")，实际启动的是 sh 进程，它再 fork 出 ping 和 grep。超时后 cmd.Process.Kill() 只杀掉 sh，ping 和 grep 变成孤儿进程继续跑——这是“以为超时了其实没停”的最常见原因。
- 优先避免
sh -c：拆成直调二进制，比如exec.Command("ping", "-c", "4", "example.com") - 必须用 shell 时，启用进程组：
cmd.SysProcAttr = &syscall.SysProcAttr{Setpgid: true}（Linux/macOS） - 超时后手动杀整个进程组：
syscall.Kill(-cmd.Process.Pid, syscall.SIGKILL)（注意负号） - Windows 不支持
Setpgid，需改用cmd.exe /C并依赖其自身进程树管理
Output() 和 CombinedOutput() 的陷阱
cmd.Output() 看起来省事，但它默认把 stderr 丢弃（除非你显式设置 cmd.Stderr = os.Stderr），而很多命令的错误信息全在 stderr 上；cmd.CombinedOutput() 虽合并输出，但大文件会 OOM。
- 调试阶段临时设
cmd.Stderr = os.Stderr，能立刻看到真实报错，避免“没反应=没执行”错觉 - 需要分离 stdout/stderr 时，分别设
cmd.Stdout和cmd.Stderr为不同bytes.Buffer或其他io.Writer - 流式处理长输出（如 tail -f、日志采集），必须用
cmd.StdoutPipe()+io.Copy，不能用Output() -
cmd.CombinedOutput()返回的err非空时，out里仍可能有内容（比如编译器 stderr 输出），别直接丢弃
