Golang执行命令与输出获取技巧

哈喽！大家好，很高兴又见面了，我是golang学习网的一名作者，今天由我给大家带来一篇《Golang执行外部命令与输出获取方法》，本文主要会讲到等等知识点，希望大家一起学习进步，也欢迎大家关注、点赞、收藏、转发! 下面就一起来看看吧！

os/exec.Command stdout为空的主因是未显式设置Stdout/Stderr为io.Writer且未调用Start/Run；推荐用Output()或StdoutPipe()+StderrPipe()；防注入需分离参数；超时应配合context.WithTimeout和Setpgid。

os/exec.Command 执行命令时 stdout 为空的常见原因

调用 os/exec.Command 后直接读 cmd.Stdout 拿不到输出，是因为默认不会自动捕获输出流。必须显式设置 Stdout 和/或 Stderr 字段为 bytes.Buffer 或其他 io.Writer 实例。

• 忘记调用 cmd.Start() 或 cmd.Run() —— 命令根本没执行
• 误以为 cmd.Output() 和 cmd.CombinedOutput() 可以复用多次 —— 它们只能调用一次，重复调用会返回 exec: Stdout already set
• 用 cmd.Stdout = &bytes.Buffer{} 但没把指针赋给变量，导致后续无法读取内容

获取命令标准输出和错误输出的两种推荐方式

简单场景用 Output()，需要区分 stdout/stderr 或做流式处理时用 StdoutPipe() + StderrPipe()。

• cmd.Output()：自动启动、等待、返回 []byte 和 error；若命令退出码非 0，error 非 nil，且 stdout 仍可读（除非被重定向）
• cmd.StdoutPipe() + cmd.StderrPipe()：需手动 cmd.Start()，然后用 io.ReadAll() 分别读取两个管道；适合实时日志、大输出或需要并发处理的情况
• 注意：使用管道时，必须在 cmd.Start() 之后、cmd.Wait() 之前读取，否则可能死锁

带参数执行命令时如何避免 shell 注入和空格截断

不要拼接字符串传给 sh -c，而应把命令和参数分开作为 Command 的参数传入。

• 错误写法：exec.Command("sh", "-c", "ls -l "+path) —— path 含空格或特殊字符就会出错或被注入
• 正确写法：exec.Command("ls", "-l", path) —— 参数由 Go 进程直接传递给子进程，不经过 shell 解析
• 如果真需要 shell 功能（如通配符、管道），明确用 exec.Command("sh", "-c", "ls *.go | head -n1")，但确保所有用户输入都经 shellescape.Quote() 处理（需引入第三方包）

超时控制与信号中断的实际写法

用 context.WithTimeout 是最可靠的方式，比手动 goroutine + channel 更简洁且不易漏掉清理。

• 直接对 cmd.Run() 加超时：cmd.Run() // 在 context 超时后自动 kill 子进程
• 必须设置 cmd.SysProcAttr = &syscall.SysProcAttr{Setpgid: true} 才能保证超时后整个进程组被终止（尤其命令内部又 fork 了子进程时）
• 不要依赖 cmd.Process.Kill() 手动杀进程 —— 它不等待退出，可能留下僵尸进程；应始终配合 cmd.Wait()

实际中容易忽略的是：即使命令执行失败（非零退出码），Output() 返回的 error 是 *exec.ExitError 类型，其 Error() 方法只返回字符串描述，真正退出码要通过 ExitCode() 方法获取（Go 1.12+），老版本需类型断言后查 sys.WaitStatus。

今天关于《Golang执行命令与输出获取技巧》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！