该选 run() 还是 output() 取决于是否需要命令输出:run() 仅判断成败,output() 自动捕获短输出;参数需拆分为命令名与切片,避免空格误传;须显式设置环境变量和工作目录;务必用 context 控制超时。

os/exec.Run() 和 os/exec.Output() 到底该选哪个
看你要不要命令的输出结果。如果只关心命令是否成功(比如 git pull、systemctl restart),用 Run();如果还要读 stdout(比如 ls -l、curl -s http://api),直接上 Output() ——它自动帮你捕获 stdout 并等命令结束,比手动 Start()+Wait() 少写三行还更安全。
常见错误是拿 Run() 去接返回值当输出用,结果得到空字符串还纳闷为啥没打印;或者用 Output() 调用一个会写大量日志的命令(比如 tail -f /var/log/syslog),直接 OOM ——因为它把所有输出全塞进内存。
-
Run():适合“执行即忘”类操作,返回error即可判断成败 -
Output():适合短输出、需解析结果的场景,注意输出大小上限 - 超长输出或需实时处理(如流式日志),得用
Cmd.StdoutPipe()配合io.Copy或逐行扫描
命令参数传错导致 “no such file or directory” 错误
这个错误几乎从不表示文件真丢了,而是 exec.Command() 的参数拆分错了。Go 不走 shell 解析,exec.Command("ls -la") 会被当成一个叫 "ls -la" 的程序去找,自然报错。
正确写法是把命令和参数分开传:exec.Command("ls", "-la", "/tmp")。空格不是分隔符,逗号才是。如果你非得拼字符串(比如从配置读),得自己用 strings.Fields() 拆,但要注意引号、转义——这时候不如换 sh -c 包一层。
立即学习“go语言免费学习笔记(深入)”;
- 绝对别把带空格的整个字符串当
exec.Command()第一个参数 - 路径含变量?用
filepath.Join()拼,别手拼"/home/" + username + "/.config" - 要执行 shell 特性(
|、&&、通配符),显式调exec.Command("sh", "-c", "ls *.go | head -n1")
环境变量和工作目录不继承,命令默默失败
Go 启动的子进程默认不继承父进程的 $PATH(尤其在 systemd 或容器里),也用当前工作目录而非你期望的项目根目录。结果就是 exec.Command("npm", "run", "build") 找不到 npm,或者 go build 报 “cannot find module”。
解决方法很简单:显式设置。用 cmd.Env 合并当前环境,再覆盖关键项;用 cmd.Dir 指定工作目录。别依赖 os.Chdir() 全局改,那会影响其他 goroutine。
- 继承全部环境:
cmd.Env = os.Environ(),再追加或覆盖,如append(os.Environ(), "GOOS=linux") - 指定工作目录:
cmd.Dir = "/path/to/project",确保相对路径能对上 - 调试时加一句
log.Printf("env: %+v, dir: %s", cmd.Env, cmd.Dir),比猜快十倍
没设超时导致 goroutine 卡死
os/exec 默认不超时。一旦调用的命令卡住(比如网络请求挂起、交互式程序等),你的 goroutine 就永远等下去,还带不走资源 —— 文件描述符、内存、甚至子进程本身都泄漏。
必须用 context.WithTimeout() 包住 cmd.Start() 和 cmd.Wait()。注意:不是给 exec.Command() 加 context,而是用 cmd.Start() 启动后,再在 Wait() 前控制超时。
- 正确姿势:
cmd.Start(); select { case - 更省事:用
exec.CommandContext(ctx, ...),它会在 ctx 取消时自动 kill 子进程(Go 1.12+) - 别只设 5 秒就完事 —— 网络命令看 RTT,编译命令看代码量,留足余量再加 20%
最常被忽略的是信号传递:子进程可能 fork 出孙进程(比如 make 调 gcc),Kill() 只杀直系子进程。真要干净收尾,得自己发 SIGTERM 后等几秒再 SIGKILL,或者用 syscall.Setpgid 拉进程组统一处理。










