如何使用Golang os/exec执行外部命令_获取命令输出结果

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：

• 避免使用 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，防止命令卡死。