如何使用Golang os/exec执行外部命令_捕获输出和错误_技术教程

Go中捕获命令输出需区分stdout与stderr：CombinedOutput适合调试，合并输出；生产环境推荐StdoutPipe/StderrPipe分别捕获；注意shell解析、路径、超时及退出码检查。

在 Go 中使用 os/exec 执行外部命令并捕获标准输出和标准错误，核心在于正确构造 *exec.Cmd、合理设置 I/O 管道，并调用 Run 或 CombinedOutput 等方法。关键不是只看是否成功，而是区分 stdout 和 stderr，并处理可能的执行失败。

使用 Cmd.CombinedOutput 一次性获取所有输出（含错误）

适合调试或简单场景：把 stdout 和 stderr 合并成一个字节切片返回，同时自动调用 Run()。如果命令失败（非零退出码），error 不为 nil，但输出仍可读。

示例：

cmd := exec.Command("ls", "-l", "/nonexistent")
output, err := cmd.CombinedOutput()
if err != nil {
    fmt.Printf("命令失败: %v\n", err)
    fmt.Printf("输出（含错误）: %s\n", output) // 通常包含 "No such file or directory"
}
fmt.Printf("原始输出: %s", output)

分别捕获 stdout 和 stderr（推荐用于生产）

当需要独立处理正常输出和错误信息（比如记录日志、解析结构化结果、向用户展示不同提示），应显式创建管道：

调用 cmd.StdoutPipe() 和 cmd.StderrPipe() 获取 io.ReadCloser
必须在 cmd.Start() 之前调用，否则 panic
启动后，用 io.ReadAll（Go 1.16+）或 io.Copy 读取内容
记得关闭管道，尤其在并发调用时避免资源泄漏

示例：

cmd := exec.Command("sh", "-c", "echo 'hello'; echo 'error msg' >&2")
stdout, _ := cmd.StdoutPipe()
stderr, _ := cmd.StderrPipe()

if err := cmd.Start(); err != nil {
    log.Fatal(err)
}

outBytes, _ := io.ReadAll(stdout)
errBytes, _ := io.ReadAll(stderr)

if err := cmd.Wait(); err != nil {
    log.Printf("命令退出异常: %v", err)
}

fmt.Printf("stdout: %s", outBytes)
fmt.Printf("stderr: %s", errBytes)

避免常见陷阱：Shell 解析、路径、超时与权限

exec.Command 默认不经过 shell，所以不能直接用 "ls -l | grep go" 这类带管道的字符串。如需 shell 功能，显式调用 sh -c 或 bash -c。

其他注意事项：

命令名用绝对路径（如 /bin/ls）或确保 PATH 环境变量已设（可通过 cmd.Env 设置）
给命令加超时：用 context.WithTimeout，再传给 exec.CommandContext
检查退出状态：即使 err == nil，也要用 cmd.ProcessState.ExitCode() 判断是否为 0（仅当 cmd.Wait() 或 cmd.Run() 返回后才可用）
Windows *意可执行文件扩展名（如 "ping.exe"），或依赖 os.LookPath 查找

简化封装：一个安全的运行函数

可封装常用逻辑，统一处理超时、I/O 和错误分类：

func RunCommand(ctx context.Context, name string, args ...string) (stdout, stderr []byte, err error) {
    cmd := exec.CommandContext(ctx, name, args...)
    var stdoutBuf, stderrBuf bytes.Buffer
    cmd.Stdout, cmd.Stderr = &stdoutBuf, &stderrBuf
    err = cmd.Run()
    return stdoutBuf.Bytes(), stderrBuf.Bytes(), err
}

// 使用：
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
out, errOut, err := RunCommand(ctx, "curl", "-s", "https://httpbin.org/get")