本文详解如何在 Go 中通过 StdoutPipe + bufio.Scanner 正确逐行捕获外部命令的实时输出，重点解决 shell 特性（如 {1..5} 展开）不被 Go 默认支持导致“只读到第一行”的常见陷阱，并提供安全、高效、可复用的实践方案。
本文详解如何在 go 中通过 stdoutpipe + bufio.scanner 正确逐行捕获外部命令的实时输出，重点解决 shell 特性（如 `{1..5}` 展开）不被 go 默认支持导致“只读到第一行”的常见陷阱，并提供安全、高效、可复用的实践方案。
在 Go 中调用外部命令并逐行处理其标准输出，是构建 CLI 工具、日志监听器或自动化脚本的高频需求。但初学者常误以为 exec.Command 会自动启用 shell 解释器（如 bash），从而直接传入含 shell 语法（如 {1..5}、$HOME、管道 | 或重定向 >）的命令字符串——这正是原代码仅输出一行的根本原因：Go 的 exec.Command 默认绕过 shell，直接执行二进制程序，不进行任何 shell 展开。
因此，exec.Command("printf", "{\"Name\": \"Bob\", \"Age\": 1}\n%.0s", "{1..5}") 实际向 printf 传递了两个字面参数：格式字符串和字面值 "{1..5}"，而非展开后的 1 2 3 4 5。printf 遇到 %.0s 时忽略后续参数，最终仅输出一次 JSON。
✅ 正确做法有两类：
1. 纯 Go 实现（推荐）——避免依赖 shell，更安全、可移植
手动构造参数，用 raw string（反引号）避免转义灾难，并使用 scanner.Bytes() 替代 []byte(scanner.Text()) 提升性能与安全性（避免重复内存分配，且 Text() 会丢弃换行符，而 Bytes() 保留原始字节）：
package main
import (
"encoding/json"
"fmt"
"log"
"os/exec"
"bufio"
)
func main() {
// ✅ 手动展开 {1..5} → 五个独立参数，无需 shell
cmd := exec.Command("printf", `{"Name": "Bob", "Age": %d}%s`, 1, "\n", 2, "\n", 3, "\n", 4, "\n", 5, "\n")
stdout, err := cmd.StdoutPipe()
if err != nil {
log.Fatal("StdoutPipe:", err)
}
scanner := bufio.NewScanner(stdout)
if err := cmd.Start(); err != nil {
log.Fatal("Start:", err)
}
var person struct {
Name string `json:"Name"`
Age int `json:"Age"`
}
for scanner.Scan() {
// ✅ 使用 Bytes()：零拷贝、保留原始编码、兼容非 UTF-8 输出
if err := json.Unmarshal(scanner.Bytes(), &person); err != nil {
log.Printf("JSON parse error: %v (raw: %q)", err, scanner.Bytes())
continue // 跳过错误行，不终止整个流程
}
fmt.Printf("%s is %d years old\n", person.Name, person.Age)
}
// 检查 scanner 是否因 I/O 错误退出
if err := scanner.Err(); err != nil {
log.Fatal("Scanner error:", err)
}
// 等待命令结束，获取退出状态
if err := cmd.Wait(); err != nil {
log.Fatal("Command failed:", err)
}
}
2. 显式调用 shell（谨慎使用）
若必须使用复杂 shell 功能（如管道、变量、通配符），可显式调用 /bin/sh -c，但需严格校验输入以防命令注入：
// ⚠️ 仅当绝对必要时使用，且确保 args 中无用户可控未过滤内容
cmd := exec.Command("/bin/sh", "-c", `printf '{"Name": "Bob", "Age": 1}\n' {1..5}`)
? 关键注意事项总结：
- ❌ 不要将 shell 语法（{1..5}, $PATH, |, &&）直接传给 exec.Command；
- ✅ 优先用 Go 原生逻辑生成参数（如 for i := 1; i
- ✅ 使用 raw string（`...`）书写 JSON/命令模板，彻底规避引号与反斜杠转义；
- ✅ scanner.Bytes() 比 []byte(scanner.Text()) 更高效、更安全；
- ✅ 总是检查 scanner.Err() 和 cmd.Wait() 的错误，区分解析失败、I/O 中断与进程异常退出；
- ✅ 对含用户输入的场景，禁用 shell 调用，防止命令注入（/bin/sh -c 是高危操作）。
遵循以上原则，即可稳定、高效、安全地实现 Go 中命令输出的逐行流式处理。
