Go语言exec包的具体使用

在 Go 里调用外部命令、执行系统程序，最核心的工具就是标准库 os/exec。它负责启动进程、传递参数、读写标准输入输出、控制超时——但凡涉及脚本化、自动化、集成第三方工具的场景，基本都绕不开它。

这篇文章会通过实际例子，把 exec 包最常用的操作从头到尾拆一遍。不求面面俱到，但求每个用法都能直接上手用。

一、exec 包核心概念

os/exec 用来创建和控制子进程。它不是直接调系统调用，而是做了几层封装：

• 默认不注入 Shell，避免了字符串拼接带来的安全隐患；
• 标准输出、标准错误、标准输入可以分开接管；
• 支持等待进程结束、强行终止、设置超时、获取退出码；
• 一个接口覆盖 Linux、macOS、Windows。

常用的几个函数和结构体：

• exec.Command(name, arg...) — 创建命令对象；
• cmd.Run() — 运行并等待完成；
• cmd.Output() — 运行并返回标准输出；
• cmd.CombinedOutput() — 返回 stdout + stderr 合并的结果；
• cmd.Start() + cmd.Wait() — 异步启动，异步等待；
• cmd.StdoutPipe() — 实时读取输出流。

二、最简单示例：执行命令并获取输出

1. 获取命令输出

直接拿到命令的 stdout，适合那种输出量不大、一次就能读完的任务：

package main

import (
	"fmt"
	"os/exec"
)

func main() {
	// Linux/macOS
	cmd := exec.Command("echo", "hello go exec")
	// Windows: cmd := exec.Command("cmd", "/c", "echo hello go exec")

	output, err := cmd.Output()
	if err != nil {
		fmt.Printf("执行失败: %v\n", err)
		return
	}

	fmt.Printf("输出结果: %s\n", output)
}

• Output() 会在退出码非 0 时返回错误；
• 返回的是 []byte，直接转成字符串就行。

2. 同时拿 stdout + stderr

如果想把正常日志和错误日志一起收集，用 CombinedOutput：

output, err := cmd.CombinedOutput()

三、只运行不关心输出

有些场景只想知道命令是否跑成功，输出可以忽略：

cmd := exec.Command("sleep", "1")
err := cmd.Run()
if err != nil {
	fmt.Println("执行失败:", err)
}

四、实时读取输出（不卡缓冲区）

注意一个容易踩的坑：如果命令输出很长，直接用 Output() 会一直等到输出结束，而且缓冲区满了还可能阻塞。正确的做法是拿管道实时消费。

package main

import (
	"io"
	"os"
	"os/exec"
)

func main() {
	// Linux/macOS 
	cmd := exec.Command("ping", "192.168.0.1", "-c", "3")
	// Windows: exec.Command("ping", "192.168.0.1", "-n", "3")

	stdout, err := cmd.StdoutPipe()
	if err != nil {
		panic(err)
	}
	cmd.Stderr = os.Stderr // 错误直接输出到终端

	if err := cmd.Start(); err != nil {
		panic(err)
	}

	// 实时拷贝到标准输出
	io.Copy(os.Stdout, stdout)

	// 等命令结束
	if err := cmd.Wait(); err != nil {
		panic(err)
	}
}

• Start() 异步启动子进程；
• Wait() 阻塞等待退出；
• io.Copy 一边读一边写，不会积压。

五、给子进程传入内容（Stdin）

有些命令需要从标准输入读数据，比如 cat：

package main

import (
	"os/exec"
	"strings"
)

func main() {
	cmd := exec.Command("cat")
	cmd.Stdin = strings.NewReader("我是输入内容\nhello exec")

	output, err := cmd.CombinedOutput()
	if err != nil {
		panic(err)
	}
	println(string(output))
}

六、设置工作目录与环境变量

cmd := exec.Command("ls")
cmd.Dir = "/tmp"          // 指定执行目录
cmd.Env = []string{       // 完全覆盖环境变量
	"PATH=/usr/bin:/bin",
	"MY_ENV=test",
}

如果不设 Env，子进程会继承当前进程的环境；一旦显式设置，就只使用你给的这些变量。

七、带超时的安全调用

防止命令因为网络、死循环等问题卡死：

package main

import (
	"context"
	"os/exec"
	"time"
)

func main() {
	// 5秒超时
	ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
	defer cancel()

	cmd := exec.CommandContext(ctx, "sleep", "10")

	err := cmd.Run()
	if err != nil {
		// 超时后会返回 context deadline exceeded
		println("命令结束:", err)
	}
}

八、获取退出码

Go 没有直接暴露 ExitCode() 方法，需要通过类型断言从 *exec.ExitError 里取：

if err != nil {
	if exitErr, ok := err.(*exec.ExitError); ok {
		fmt.Println("退出码:", exitErr.ExitCode())
	}
}

九、几个容易踩的坑

1. 不要手动拼接命令字符串

错误写法：

exec.Command("echo hello world") // 这里只传了一个参数，会被当作可执行文件名

正确做法：

exec.Command("echo", "hello", "world")

2. Windows 下要显式调用 cmd /c

exec.Command("cmd", "/c", "dir")

3. 处理输出乱码（Windows 常见）

Windows 命令的输出通常使用 GBK 编码，直接读出来会乱码。需要借助 golang.org/x/text 做转码：

package main

import (
	"bytes"
	"io"
	"os/exec"

	"golang.org/x/text/encoding/simplifiedchinese"
	"golang.org/x/text/transform"
)

func main() {
	// Windows 执行 ipconfig
	cmd := exec.Command("ipconfig")

	var buf bytes.Buffer
	// 输出：GBK → UTF-8
	cmd.Stdout = transform.NewWriter(&buf, simplifiedchinese.GBK.NewDecoder())
	cmd.Stderr = transform.NewWriter(&buf, simplifiedchinese.GBK.NewDecoder())

	_ = cmd.Run()
	println(buf.String()) // 中文不再乱码
}

4. 大量输出时不要用 Output()，用 StdoutPipe

前面已经演示过了，输出量一大，Output() 会因为内部缓冲区满而阻塞，子进程写不进去也会卡住。

5. 不处理 stdout/stderr 可能导致死锁

如果子进程产生大量输出，但你既不读 stdout 也不设管道，缓冲区一旦满，子进程会阻塞在写操作上，而 Run() 要等子进程结束才返回——结果就是程序卡死。

package main

import (
	"os/exec"
)

// 这个程序会 100% 卡死！
func main() {
	// 生成大量输出的命令（Windows 示例）
	cmd := exec.Command("cmd", "/c", "echo 大量行&for /L %i in (1,1,5000) do @echo 这是一行测试数据")

	// 关键错误：不设置 Stdout、Stderr
	err := cmd.Run()
	println("永远到不了这里", err)
}

解决方法很简单：要么用 StdoutPipe 实时消费，要么把 cmd.Stdout 和 cmd.Stderr 指向 os.Stdout / os.Stderr，千万别留空导致管道被堵。