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(推荐用于生产)
当需要独立处理正常输出和错误信息(比如记录日志、解析结构化结果、向用户展示不同提示),应显式创建管道:
立即学习“go语言免费学习笔记(深入)”;
- 调用
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")










