Go os/exec 怎样设置命令工作目录

用 Go 启动外部命令时，如果命令依赖相对路径，真正要设置的不是当前 Go 进程的目录，而是 exec.Cmd 的 Dir 字段。把目录赋给 cmd.Dir 后，再调用 Output、CombinedOutput 或 Run，子进程就会从这个目录开始工作；空字符串则继续沿用父进程当前目录。

Go os/exec 官方文档：https://pkg.go.dev/os/exec

最小配方是：创建 Cmd、设置 Cmd.Dir、选择输出方法、区分启动错误与非零退出错误。

先把工作目录设置在 Cmd.Dir

常见症状是：同一条命令在终端里能找到配置文件，放进 Go 服务后却提示文件不存在。先看命令使用的相对路径是相对于谁；子进程看到的工作目录由 Cmd.Dir 决定，不会因为调用方执行了 os.Chdir 就自动获得更清晰的边界。

最小配方可以这样写：

package runner

import (
	"fmt"
	"os/exec"
)

// RunInDir 让命令在指定目录启动，并返回合并后的标准输出和错误输出。
func RunInDir(dir string, name string, args ...string) ([]byte, error) {
	cmd := exec.Command(name, args...)
	// Dir 为空时沿用父进程目录；非空时作为子进程工作目录。
	cmd.Dir = dir
	// CombinedOutput 便于把命令诊断信息和正常输出一起交给上层。
	out, err := cmd.CombinedOutput()
	if err != nil {
		return out, fmt.Errorf("命令 %q 在 %q 中执行失败: %w", name, dir, err)
	}
	return out, nil
}

目录只应来自明确的配置、任务目录或已经规范化的路径。不要把用户输入直接拼成任意目录；需要根据当前进程目录补全相对路径时，可以在边界层调用 filepath.Abs，并把失败作为参数错误返回。

用 Output 或 CombinedOutput 接收结果

Output 返回标准输出；CombinedOutput 会把标准输出与标准错误合并。选择哪一个取决于上层是否需要保留两个通道。对于构建工具、格式转换器这类既有结果又会输出诊断的命令，合并读取通常更容易记录；对于机器可读输出，则应避免把错误文本混进结果。

package runner

import (
	"bytes"
	"os/exec"
)

// RunWithSeparateOutput 保留标准输出和标准错误的边界。
func RunWithSeparateOutput(dir string, name string, args ...string) (string, string, error) {
	cmd := exec.Command(name, args...)
	cmd.Dir = dir
	var stdout bytes.Buffer
	var stderr bytes.Buffer
	// 两个缓冲区分别接收两个通道，避免解析结果时混入诊断文本。
	cmd.Stdout = &stdout
	cmd.Stderr = &stderr
	if err := cmd.Run(); err != nil {
		return stdout.String(), stderr.String(), err
	}
	return stdout.String(), stderr.String(), nil
}

如果只是确认目录是否生效，可以让子进程输出它自己的当前目录。Unix 示例常用 sh -c pwd；Windows 则应换成目标环境可用的命令形式。不要把某个平台的命令写成跨平台抽象，平台差异应该留在调用适配层。

分别处理启动错误和退出错误

“执行失败”至少有两种含义：进程根本没有启动，或者进程启动了但以非零状态退出。目录不存在、可执行文件找不到、权限不足通常发生在启动阶段；命令内部发现输入无效后返回非零状态，则属于退出错误。

package runner

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

// DescribeFailure 把启动失败和命令非零退出转换成可读信息。
func DescribeFailure(err error) string {
	if err == nil {
		return "命令成功"
	}
	var exitErr *exec.ExitError
	// 能解包为 ExitError，说明进程已经启动但返回了非零状态。
	if errors.As(err, &exitErr) {
		return fmt.Sprintf("命令已启动但退出码为 %d", exitErr.ExitCode())
	}
	// 其他错误通常发生在查找可执行文件或准备工作目录阶段。
	return "命令未能正常启动: " + err.Error()
}

上层还可以记录 out 或独立的 stderr，再根据错误类型决定重试、标记任务失败还是提示配置问题。不要只判断 err != nil 后丢掉输出，否则最有用的目录或参数诊断也会一起消失。

把路径和平台差异留在边界层

Dir 接受的是文件系统路径，不是 URL，也不是给 shell 解析的字符串。路径拼接优先使用 filepath.Join，不要手写斜杠；命令名和参数则通过 exec.Command 的参数传递，不要为了“方便”把整段输入拼到 shell 字符串里。

package runner

import (
	"fmt"
	"os/exec"
	"path/filepath"
)

// BuildCommand 只负责构造 Cmd，平台相关的命令名由调用方传入。
func BuildCommand(root string, name string, args ...string) (*exec.Cmd, error) {
	dir, err := filepath.Abs(root)
	if err != nil {
		return nil, fmt.Errorf("解析工作目录失败: %w", err)
	}
	cmd := exec.Command(name, args...)
	// 先固定绝对工作目录，再把 Cmd 交给执行层。
	cmd.Dir = dir
	return cmd, nil
}

如果命令需要读取工作目录中的文件，路径相对关系由子进程负责解释；如果 Go 代码本身也要读同一文件，最好把绝对目录或已拼好的路径显式传给两边，避免父进程和子进程各自推导出不同位置。

用小型包装函数收敛调用约定

实际项目可以把目录、参数、输出和错误处理收进一个小包装函数。这样业务层只关心“在哪个任务目录运行什么命令”，不会在每个调用点重复遗漏 Dir、混淆输出通道或丢失退出码。

速查规则如下：

几个容易混淆的问题

设置了 Cmd.Dir，还要修改 os.Chdir 吗？

通常不需要。Cmd.Dir 只影响该子进程，能避免修改整个 Go 进程的全局工作目录；除非业务明确要求改变父进程状态，否则优先使用它。

目录不存在时能拿到 ExitError 吗？

不能把它当作普通退出。进程可能尚未启动，返回的是启动阶段错误；先保留原始错误文本，通常比强行读取退出码更准确。

为什么命令在终端里正常，Go 中却找不到文件？

重点检查工作目录、环境变量和平台命令形式。终端可能先切换过目录，或通过 shell 提供了额外环境；Go 的 exec.Command 不会自动替你复现这些隐式状态。

归纳起来，Go os/exec 设置工作目录的核心只有一个字段：Cmd.Dir。把它与参数构造、输出读取和错误分类分开，命令调用就能从“依赖运行环境的字符串”变成可复用、可诊断的执行边界。