Go 中合并命令 stdout 和 stderr 的方法

本文深入解析了在 Go 中调用外部命令时如何正确合并 stdout 和 stderr 流——摒弃易导致顺序错乱、竞态和阻塞的传统双管道并发读取方式，转而采用简洁可靠的 `cmd.Stderr = cmd.Stdout` 重定向方案，确保输出严格按进程实际写入顺序实时聚合，并附有可直接运行的完整示例与关键注意事项，是构建健壮 CLI 工具、CI/CD 日志系统等场景不可或缺的实用技巧。

本文介绍在 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 工具封装等真实场景。

到这里，我们也就讲完了《Go 中合并命令 stdout 和 stderr 的方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！