Golang命令执行错误处理技巧

在 Go 中使用 `exec.Command` 执行外部命令时，错误处理远不止检查 `err != nil` 那么简单：失败时返回的 `*exec.ExitError` 需要类型断言才能提取真实退出码，而更可靠的方式是调用 `cmd.Wait()` 后通过 `cmd.ProcessState.ExitCode()` 获取——它不仅兼容正常退出、信号终止甚至启动失败等边界场景，还能配合 `Signaled()`、`Success()` 等方法实现精细化状态判断；但务必注意 `Start()` 后必须 `Wait()` 才能安全访问 `ProcessState`，否则会 panic；同时别误信 `ExitError.Stderr`（它恒为 `nil`），需显式配置 `Stdout`/`Stderr` 捕获输出，结合 `context.WithTimeout` 和 `WaitTimeout`（Go 1.22+）才能构建健壮、可观察、跨平台稳定的命令执行逻辑。

Go exec.Command 执行失败时为什么 err 不是 nil 却拿不到退出码

因为 exec.Command 的 Run 或 Start + Wait 返回的 err 是封装后的 *exec.ExitError，它本身不是原始退出码。直接打印 err 只能看到类似 exit status 2 的字符串，无法直接参与逻辑判断。

• 必须用类型断言判断是否为 *exec.ExitError，再调用其 ExitCode() 方法
• Cmd.Output() 和 Cmd.CombinedOutput() 在命令失败时也会返回非 nil 的 err，且同样需要类型断言才能取码
• 注意：Windows 下 ExitCode() 返回值可能不可靠（某些 cmd.exe 场景会返回 0 即使执行失败），Linux/macOS 更稳定

cmd := exec.Command("sh", "-c", "exit 3")
err := cmd.Run()
if exitErr, ok := err.(*exec.ExitError); ok {
    fmt.Println("exit code:", exitErr.ExitCode()) // 输出 3
}

用 Cmd.ProcessState 比 err 更稳妥地获取退出状态

Cmd.ProcessState 是命令执行完后的真实状态快照，只要 Wait 已完成（即命令已结束），它就一定可用，不依赖 err 是否为 *exec.ExitError ——哪怕命令因信号终止（如被 kill -9）、或根本没启动成功，ProcessState 仍能提供更细粒度信息。

• 调用 cmd.Wait() 后，优先检查 cmd.ProcessState != nil，再用 ProcessState.ExitCode()
• ProcessState.Success() 可直接判断是否“逻辑成功”（即退出码为 0），比手动比较更语义清晰
• 若需区分崩溃、被杀、超时等场景，可用 ProcessState.Signal() 和 ProcessState.String()

cmd := exec.Command("sleep", "1")
_ = cmd.Start()
time.Sleep(50 * time.Millisecond)
_ = cmd.Process.Kill()
_ = cmd.Wait()
if cmd.ProcessState != nil {
if cmd.ProcessState.Signaled() {
fmt.Println("killed by signal:", cmd.ProcessState.Signal())
} else {
fmt.Println("exit code:", cmd.ProcessState.ExitCode())
}
}

常见错误：把 os/exec 当同步函数用，漏掉 Wait 就读 ProcessState

cmd.Start() 启动后立即返回，此时进程还在跑，cmd.ProcessState 为 nil；不 Wait 就强行读，会 panic 或得到空值。很多脚本式写法（比如只调 Run）躲开了这问题，但一旦需要并发控制或超时，就容易栽在这里。

• 用 cmd.Start() 必须配对 cmd.Wait() 或 cmd.WaitTimeout()（Go 1.22+）
• 用 context.WithTimeout 控制超时时，记得在 defer cancel() 前先 Wait，否则子进程可能残留
• 如果只关心输出不关心状态，Output() 内部已自动 Wait，不用额外处理

ExitError 的 Stdout/Stderr 字段基本没用，别指望它存输出

*exec.ExitError 类型里确实有 Stdout 和 Stderr 字段，但它们始终是 nil ——Go 标准库不会自动捕获并塞进去。这是文档没明说、但源码里写死的行为。

• 想同时拿到输出和退出码，必须显式设置 cmd.Stdout 和 cmd.Stderr 为 bytes.Buffer 或其他 io.Writer
• 用 CombinedOutput() 时，输出统一进 stdout，错误流也混在里面，退出码仍需类型断言
• 不要写 exitErr.Stderr.Bytes()，它永远 panic

有些组合行为（比如信号中断 + 非零退出 + stderr 内容）得靠 ProcessState + 显式管道 + 上下文超时三者配合，少一个环节状态就残缺。

今天关于《Golang命令执行错误处理技巧》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！