Go中执行外部命令获取输出有三种方式:1. Cmd.Output()适合简单成功命令,返回stdout但不捕获stderr;2. 分别设置Stdout/Stderr为bytes.Buffer配合Run()可同时捕获两者;3. StdoutPipe()+goroutine适合实时流式处理。

在 Go 中使用 os/exec 执行外部命令并获取输出结果,核心是调用 Cmd.Output() 或组合 StdoutPipe + Run。关键在于区分“成功执行但有输出”和“命令失败但仍有 stderr 输出”两种情况。
直接获取标准输出(适合简单命令)
若命令预期成功(退出码为 0),且只需标准输出(stdout),Cmd.Output() 最简洁:
- 它自动启动进程、等待结束,并返回 stdout 内容;
- 若命令失败(非零退出码),
Output()会返回 error,但依然可读取其[]byte输出(即实际打印的内容); - 注意:它不捕获 stderr,错误信息会被丢弃或输出到当前终端(除非显式重定向)。
示例:
cmd := exec.Command("echo", "hello world")
output, err := cmd.Output()
if err != nil {
// err 是 *exec.ExitError 类型,可检查 ExitCode()
fmt.Printf("命令失败,退出码: %d\n", err.(*exec.ExitError).ExitCode())
}
fmt.Printf("输出: %s", output) // 输出: hello world
同时捕获 stdout 和 stderr(推荐用于调试或健壮逻辑)
当需要完整观察命令行为(比如日志分析、错误诊断),应分别设置 Stdout 和 Stderr 为 bytes.Buffer:
立即学习“go语言免费学习笔记(深入)”;
- 避免使用
Output()或CombinedOutput(),改用Run(); - 手动创建两个
bytes.Buffer,赋值给cmd.Stdout和cmd.Stderr; - 调用
Run()后,从 buffer 中读取字符串即可。
示例:
var stdoutBuf, stderrBuf bytes.Buffer
cmd := exec.Command("ls", "-l", "/nonexistent")
cmd.Stdout = &stdoutBuf
cmd.Stderr = &stderrBuf
err := cmd.Run() // 注意用 Run(),不是 Output()
stdout := stdoutBuf.String()
stderr := stderrBuf.String()
fmt.Printf("stdout: %s\n", stdout)
fmt.Printf("stderr: %s\n", stderr)
if err != nil {
fmt.Printf("执行失败: %v\n", err)
}
实时处理输出流(适合长时运行命令)
对于持续输出的命令(如 ping、tail -f),需用管道(Pipe)配合 goroutine 实时读取:
- 调用
cmd.StdoutPipe()获取io.ReadCloser; - 在新 goroutine 中循环
Read()或用bufio.Scanner行读取; - 务必先
Start()再读取,最后调用Wait()等待结束。
示例(逐行打印 ping 输出):
cmd := exec.Command("ping", "-c", "3", "google.com")
stdout, _ := cmd.StdoutPipe()
cmd.Start()
scanner := bufio.NewScanner(stdout)
for scanner.Scan() {
fmt.Println(">>", scanner.Text())
}
cmd.Wait()
常见陷阱与注意事项
以下几点容易出错,需特别留意:
-
参数不要拼接字符串:用
exec.Command("ls", "-l", "/path"),而非exec.Command("ls -l /path"),否则 shell 解析失效; -
路径问题:命令名默认从
$PATH查找;若需绝对路径,直接传入(如/bin/ls); -
环境变量:可通过
cmd.Env设置,例如追加append(os.Environ(), "DEBUG=1"); -
超时控制:用
cmd.Context()配合context.WithTimeout,防止命令卡死。










