本文介绍在 Go 中使用 exec.Command 同时捕获并合并子进程的标准输出（stdout）与标准错误（stderr）流的正确方法，避免分别处理导致的顺序错乱或遗漏，并提供可直接运行的完整示例。
本文介绍在 go 中使用 `exec.command` 同时捕获并合并子进程的标准输出（stdout）与标准错误（stderr）流的正确方法，避免分别处理导致的顺序错乱或遗漏，并提供可直接运行的完整示例。
在 Go 中调用外部命令（如 docker build）时，若希望统一处理 stdout 和 stderr（例如实时日志聚合、统一着色或按时间序输出），不能简单地为两者分别创建独立的 Pipe() 并并发读取——这不仅增加复杂度，更关键的是：Go 的 StdoutPipe() 和 StderrPipe() 返回的 reader 在底层不保证输出顺序与实际进程写入顺序一致，且存在竞态与阻塞风险。
正确的做法是：将 cmd.Stderr 显式设置为与 cmd.Stdout 相同的 io.WriteCloser（即复用同一管道）。这样所有写入 stdout 和 stderr 的数据都会流入同一个 reader，天然保持原始输出时序。
以下是修正后的完整实现：
package main
import (
"bufio"
"fmt"
"os"
"os/exec"
)
func runCommand() {
cmdName := "docker"
cmdArgs := []string{"build", "--no-cache=true", "--force-rm=true", "."}
cmd := exec.Command(cmdName, cmdArgs...)
// 创建单个 stdout 管道
stdoutReader, err := cmd.StdoutPipe()
if err != nil {
fmt.Fprintf(os.Stderr, "Error creating StdoutPipe: %v\n", err)
return
}
// 关键：将 stderr 重定向到同一管道
cmd.Stderr = cmd.Stdout
scanner := bufio.NewScanner(stdoutReader)
go func() {
for scanner.Scan() {
fmt.Printf("docker build | %s\n", scanner.Text())
}
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），但 stderr 内容已通过管道输出
fmt.Fprintf(os.Stderr, "Command finished with error: %v\n", err)
}
}
func main() {
runCommand()
}✅ 关键要点说明：
- cmd.Stderr = cmd.Stdout 必须在调用 cmd.StdoutPipe() 之后、cmd.Start() 之前设置，否则 StdoutPipe() 可能返回 nil 或引发 panic；
- 不要调用 cmd.StderrPipe() —— 因为 stderr 已被重定向，再调用会覆盖重定向，导致行为未定义；
- 使用 bufio.Scanner 时务必检查 scanner.Err()，以捕获读取过程中的 I/O 错误（如管道提前关闭）；
- 若需区分原始流来源（如标记 [stdout] / [stderr]），此方案不适用，应改用 io.MultiReader 或 io.TeeReader 配合自定义 writer 实现带标签的合并。
该方法简洁、高效、符合 Go 最佳实践，适用于 CI/CD 日志采集、CLI 工具封装等真实场景。
