Go os/exec设置工作目录与环境变量的可靠写法

Go 调用外部命令时，可靠做法是把工作目录写入 cmd.Dir，用 cmd.Environ() 继承后再追加环境变量，并把标准输出、标准错误和 Run 返回的错误分开保存。这样即使命令退出失败，也能看清它在哪个目录运行、拿到了什么环境，以及具体输出了什么。

先固定 Cmd.Dir，再构造继承环境

exec.Command 只负责构造命令对象，真正运行前可以设置 Dir 和 Env。例如构建任务需要在项目根目录执行，同时给子进程注入一个模式变量：

package main

import (
    "bytes"
    "fmt"
    "os/exec"
)

func runTask() error {
    cmd := exec.Command("go", "env", "GOMOD")
    cmd.Dir = "/workspace/project" // 只设置子进程目录，不改变父进程目录

    env := cmd.Environ() // 先继承当前环境，保留 PATH 等基础变量
    env = append(env, "APP_MODE=worker") // 再追加本次任务需要的变量
    cmd.Env = env

    var stdout, stderr bytes.Buffer
    cmd.Stdout = &stdout // 保存标准输出，便于读取正常结果
    cmd.Stderr = &stderr // 保存标准错误，便于定位命令自身的诊断信息

    if err := cmd.Run(); err != nil { // 启动失败或退出码非零都会在这里体现
        return fmt.Errorf("run task: %w; stderr=%s", err, stderr.String())
    }
    fmt.Printf("GOMOD=%s", stdout.String())
    return nil
}

这里的关键顺序是先创建命令、再设置 Dir、最后构造 Env。cmd.Environ() 返回当前配置下适合继续修改的环境切片；如果直接写成 cmd.Env = []string{"APP_MODE=worker"}，外部程序可能找不到依赖于 PATH 的可执行文件。

标准输出、标准错误与退出错误要分开看

命令输出和 Go 错误属于不同层次。stdout 通常承载结果，stderr 可能包含警告或诊断信息；Run 返回的 error 则说明启动阶段失败，或进程已经启动但以非零状态退出。排查时先读 stderr，再用 errors.As 判断是否是 *exec.ExitError：

var exitErr *exec.ExitError
if err := cmd.Run(); err != nil {
    if errors.As(err, &exitErr) { // 命令已启动，退出状态可从 ExitError 获取
        fmt.Printf("exit code=%d\n", exitErr.ExitCode())
    }
    fmt.Printf("stderr=%s\n", stderr.String()) // 保留命令自己的诊断文本
    return err
}

如果工作目录不存在，通常在启动阶段就会失败；如果命令找不到，错误可能指向 PATH 或文件名；如果目录和环境都正确但退出码非零，则应重点查看 stderr 与参数。文章示例把这些信息分别保留，便于日志系统按“配置问题”和“命令业务失败”分类。

上线前的目录、环境和错误检查清单

还要注意，os/exec 不会自动调用 shell，也不会展开通配符、管道或重定向。需要这些能力时应明确调用受控 shell，并对外部输入做边界处理；普通命令参数则继续使用参数切片，避免把多个参数拼成一条字符串。

相关问题

cmd.Dir 会改变 Go 程序自己的工作目录吗？

不会。它只为启动的子进程指定工作目录，父进程仍保持原目录。

为什么设置了 Env 后命令突然找不到？

最常见原因是覆盖了完整环境，连 PATH 也被清掉。先调用 cmd.Environ() 再追加自定义变量。

stderr 有内容就代表命令失败吗？

不一定。有些程序把警告写到 stderr 但仍返回零退出码，最终是否失败应结合 Run 的 error 和退出状态判断。