Golang使用os/exec执行外部命令指南

os/exec.Command 命令不执行或报“executable file not found”主因是未提供完整路径且未继承PATH，应优先用exec.LookPath查找；参数含空格时直接传参即可，无需拼接字符串；需设超时并管理进程组防hang。

os/exec.Command 传参时为什么命令不执行或报错 "executable file not found"

常见原因是没提供完整路径，或 PATH 环境未继承。Go 默认不读取 shell 的 PATH，exec.Command("ls") 会失败，除非系统在 /usr/bin/ls 或 /bin/ls —— 但不能依赖这个。

稳妥做法是用 exec.LookPath 查找可执行文件位置：

path, err := exec.LookPath("curl")
if err != nil {
    log.Fatal(err)
}
cmd := exec.Command(path, "-I", "https://example.com")

• 避免硬编码路径（如 "/usr/bin/curl"），不同系统路径可能不同
• exec.LookPath 会按当前进程的 PATH 环境变量查找，行为和 shell 一致
• 若命令本就来自用户输入，且你信任其安全性，也可用 exec.Command("sh", "-c", userCmd)，但注意注入风险

想捕获 stdout/stderr 又不想阻塞，该用 Run、Start 还是 CombinedOutput

三者适用场景差异明显：Run 最常用但会阻塞直到命令结束；Start + Wait 适合需要异步控制；CombinedOutput 仅适合“只要结果、不关心流分离”的简单场景。

典型误用：用 CombinedOutput 拿日志却发现 stderr 被吞掉（其实没吞，是混进 stdout 了）——如果你要分别处理输出，必须显式设置 cmd.Stdout 和 cmd.Stderr：

cmd := exec.Command("ping", "-c", "2", "google.com")
var stdout, stderr bytes.Buffer
cmd.Stdout = &stdout
cmd.Stderr = &stderr
err := cmd.Run()
// stdout.String() 和 stderr.String() 各自独立

• Run() 自动调用 Start() 再 Wait()，适合同步执行
• 需要实时读取（比如 tail 日志），得用 cmd.StdoutPipe() 配合 goroutine
• CombinedOutput 本质是把 Stdout 和 Stderr 指向同一个 bytes.Buffer，无法区分来源

如何安全传递含空格或特殊字符的参数（比如文件路径、JSON 字符串）

别拼接字符串传给 exec.Command("sh", "-c", ...) —— 这是 shell 注入高危区。Go 的 exec.Command 第二个及之后参数自动按「参数列表」传给进程，无需手动转义。

例如运行 cp "/path/with space/file.json" "/dest/dir/"，正确写法是：

src := "/path/with space/file.json"
dst := "/dest/dir/"
cmd := exec.Command("cp", src, dst)

• Go runtime 会原样把每个参数作为 argv[i] 传给 execve，操作系统负责拆分，不经过 shell
• 只有当你明确需要 shell 功能（管道、通配符、重定向）时，才用 exec.Command("sh", "-c", "cp *.txt /tmp/")，此时需自行清理用户输入
• JSON 字符串同理：exec.Command("jq", ".", jsonStr) 安全；但 exec.Command("sh", "-c", "echo "+jsonStr) 危险

子进程卡住或 SIGPIPE 导致父进程 hang 住怎么办

常见于子进程输出大量内容而父进程没及时读取，导致管道缓冲区满、子进程阻塞在 write。更隐蔽的是：父进程提前退出，子进程变成孤儿，还占着资源。

关键对策是设超时 + 杀掉整个进程组：

ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()

cmd := exec.CommandContext(ctx, "find", "/", "-name", "large.log")
cmd.SysProcAttr = &syscall.SysProcAttr{Setpgid: true} // 创建新进程组

err := cmd.Run()
if ctx.Err() == context.DeadlineExceeded {
    // 强制杀掉整个进程组（包括 find 启动的子进程）
    process, _ := cmd.Process()
    syscall.Kill(-process.Pid, syscall.SIGKILL) // 负号表示进程组
}

• exec.CommandContext 是必备项，避免无限等待
• SysProcAttr.Setpgid = true 让子进程自成一组，后续可用负 PID 杀全组
• Windows 不支持进程组，需用 cmd.Process.Kill()，但无法保证子子孙孙全退
• 即使加了超时，也要检查 err 是否为 context.DeadlineExceeded，而不是只看非 nil

实际项目里最常被忽略的是进程组管理 —— 很多人只 kill 主进程，却留下一堆僵尸子进程，跑久了内存和句柄就爆了。