本文介绍在 go 中执行外部命令时，如何将标准输出（stdout）与标准错误（stderr）统一捕获为单一流，避免分别处理带来的复杂性，并提供可直接运行的完整示例代码。
本文介绍在 go 中执行外部命令时，如何将标准输出（stdout）与标准错误（stderr）统一捕获为单一流，避免分别处理带来的复杂性，并提供可直接运行的完整示例代码。
在 Go 的 os/exec 包中，Cmd.StdoutPipe() 和 Cmd.StderrPipe() 分别返回独立的 io.ReadCloser，但若需将两者内容按时间顺序混合输出（例如日志调试、实时流式展示），最简洁高效的方式是复用同一个管道：将 cmd.Stderr 直接赋值为 cmd.Stdout，再仅调用一次 cmd.StdoutPipe() 即可同时捕获两类输出。
关键原理在于：当 cmd.Stderr = cmd.Stdout 时，子进程写入 stderr 的数据将被重定向至与 stdout 相同的底层 io.Writer（即管道写端），从而自然合并。注意此操作必须在调用 cmd.Start() 之前完成，且不能同时调用 cmd.StderrPipe()，否则会触发 panic（“exec: Stderr already set”）。
以下是修正后的完整可运行示例（以 docker build 为例，已适配现代 Docker CLI 参数）：
package main
import (
"bufio"
"fmt"
"os"
"os/exec"
"strings"
)
func runCommand() {
cmdName := "docker"
cmdArgs := []string{"build", "--no-cache", "--force-rm", "."}
cmd := exec.Command(cmdName, cmdArgs...)
// ✅ 合并 stdout 和 stderr：复用同一管道
stdoutReader, err := cmd.StdoutPipe()
if err != nil {
fmt.Fprintf(os.Stderr, "Error creating StdoutPipe: %v\n", err)
return
}
cmd.Stderr = cmd.Stdout // 关键：重定向 stderr 到 stdout 管道
// 启动 goroutine 实时读取合并后的输出
scanner := bufio.NewScanner(stdoutReader)
go func() {
for scanner.Scan() {
line := strings.TrimSpace(scanner.Text())
if line != "" {
fmt.Printf("[OUT/ERR] %s\n", line)
}
}
if err := scanner.Err(); err != nil {
fmt.Fprintf(os.Stderr, "Scanner error: %v\n", err)
}
}()
// 启动并等待命令结束
if err := cmd.Start(); err != nil {
fmt.Fprintf(os.Stderr, "Error starting command: %v\n", err)
return
}
if err := cmd.Wait(); err != nil {
// 注意：cmd.Wait() 返回的 err 包含退出状态（如 exit code 1），但输出已由管道捕获
fmt.Fprintf(os.Stderr, "Command finished with error: %v\n", err)
}
}
func main() {
runCommand()
}⚠️ 注意事项：
- 不要同时设置 cmd.Stdout 和 cmd.Stderr 为不同管道，否则 StdoutPipe()/StderrPipe() 将失效；
- 若需区分 stdout/stderr 来源，应改用 io.MultiReader 分别读取两个管道，再按需合并（但会丢失严格的时间交错顺序）；
- cmd.Stderr = cmd.Stdout 仅适用于希望完全合并的场景；若需保留来源标识，建议使用 cmd.CombinedOutput()（适合一次性获取全部输出），或通过 syscall 级重定向 + 自定义 io.Writer 实现带标签的日志。
通过上述方式，你即可用最少代码实现命令输出的统一捕获与实时处理，兼顾简洁性与实用性。
