Go os/exec Cmd.ProcessState 怎样读取子进程退出状态

调用外部命令后，如果只看 Run 返回的 error，很容易把“程序启动失败”和“程序已经启动但返回非零”混在一起。更稳妥的做法是：先判断启动是否成功，再在 Run 或 Wait 完成后读取 cmd.ProcessState。

官方地址：https://pkg.go.dev/os/exec#Cmd.ProcessState

ProcessState 只在子进程成功启动并完成 Run 或 Wait 后才有意义。成功退出时可以读取退出码和成功状态；启动失败时它可能仍是 nil，不能直接调用方法。

先分清启动错误和退出错误

exec.Command 只是构造 Cmd，真正启动发生在 Run 或 Start。如果可执行文件找不到、权限不允许启动，错误发生在启动阶段，通常还没有可供读取的 ProcessState。如果进程已经启动，随后以非零状态结束，返回值通常是 *exec.ExitError，这时才适合结合 cmd.ProcessState 解释退出结果。

Run 和 Start 加 Wait 怎么选

只关心命令结束后的状态时，Run 最紧凑：它负责启动并等待，完成后会填充 ProcessState。需要在进程运行期间读写管道、做取消控制或把等待动作放到更明确的边界时，选择 Start 加 Wait。两种写法的共同点是不能在进程尚未结束时把 ProcessState 当成最终结果。

下面的例子用 Unix shell 返回一个非零退出码，只用来展示状态判断；在 Windows 环境中应换成目标平台可用的命令，不要把 sh 当成跨平台依赖。

package main

import (
    "errors"
    "fmt"
    "os/exec"
)

func main() {
    // 这个命令用于演示“已启动但非零退出”，不是启动失败。
    cmd := exec.Command("sh", "-c", "exit 7")
    err := cmd.Run()

    // 启动失败时没有可读取的进程状态，先处理 error 再访问字段。
    if cmd.ProcessState == nil {
        fmt.Printf("命令未完成启动: %v\n", err)
        return
    }

    // ExitError 说明进程已经运行，但没有以成功状态结束。
    var exitErr *exec.ExitError
    if errors.As(err, &exitErr) {
        fmt.Printf("非零退出: code=%d, success=%v\n",
            cmd.ProcessState.ExitCode(), cmd.ProcessState.Success())
        return
    }
    if err != nil {
        // 这里保留其他 I/O 或等待错误，不把它们误报成普通退出码。
        fmt.Printf("等待命令时出错: %v\n", err)
        return
    }
    fmt.Printf("正常退出: code=%d\n", cmd.ProcessState.ExitCode())
}

这个判断顺序的价值在于保留了错误语义：ProcessState == nil 说明不能继续读状态；*exec.ExitError 说明命令已经运行但结果不成功；其他错误则可能来自 I/O 或等待过程，应该单独记录。

ExitCode、Success 和 Exited 怎么配合

ExitCode() 返回已退出进程的退出码；如果进程尚未退出，或被信号终止，官方定义的结果是 -1。因此 -1 不是一个可以随便映射成“业务失败码 1”的普通值。Success() 更适合表达“是否成功结束”，而 Exited() 用来表达程序是否通过正常退出路径结束。

在 Unix 系统上，进程被信号终止时，Exited() 可能为 false；这时若需要更细的信号信息，应根据平台读取 ProcessState.Sys() 并使用对应的系统类型。跨平台代码不要把 Unix 的底层等待状态字段当成通用业务协议。

func describeState(cmd *exec.Cmd) string {
    // 调用方应在 Run 或 Wait 返回之后调用本函数。
    state := cmd.ProcessState
    if state == nil {
        return "进程没有成功启动或尚未完成等待"
    }

    // Success 适合做总体判断，ExitCode 适合记录可检索的退出码。
    return fmt.Sprintf("success=%v exited=%v exit_code=%d",
        state.Success(), state.Exited(), state.ExitCode())
}

资源收口和选择结论

采用 Start 时，成功启动后必须调用 Wait；官方文档明确说明 Wait 会等待命令结束、处理关联的 I/O，并释放 Cmd 相关资源。不要为了读取状态而省略它，也不要并发调用多个 Wait。

可以把结论压缩成一句话：Run 或 Wait 之后再读 ProcessState，用 Success 判断总体结果，用 ExitCode 留存退出码，用 Exited 和平台信息解释信号终止；启动失败时则先处理错误，不要解引用空状态。

常见问题

为什么 cmd.ProcessState 是 nil？

通常是命令尚未成功启动，或者还没有完成 Run/Wait。先检查启动和等待返回的错误，不要直接调用 ExitCode。

ExitCode 返回 -1 就一定是退出失败吗？

不一定。官方语义是进程尚未退出或被信号终止时返回 -1，它本身不能替代 Success 和错误类型判断。