Go os/exec Cmd.Environ 获取子进程完整环境的使用方法

要在 Go 中确认子进程真正会拿到哪些环境变量，关键是先配置 cmd.Dir 和 cmd.Env，再调用 cmd.Environ() 读取结果。它返回的是当前命令配置对应的环境副本，不会执行命令；修改这个副本后，还要重新赋给 cmd.Env 才会影响子进程。

官方地址：https://pkg.go.dev/os/exec#Cmd.Environ

先把 Cmd.Environ 和 Cmd.Env 分成两个职责

Cmd.Env 是输入配置，Cmd.Environ 是“按当前配置整理出的待运行环境”。这个区别很容易被忽略：拿到返回切片后直接 append 并不会修改命令对象，必须写回 cmd.Env。

设置 Dir 后读取一份可继承的环境

下面做一个很小的命令行工具：进入 ./sandbox，将 MODE 设置为 preview，执行后打印 PWD 和 MODE。示例用 Unix 的 sh 读取环境，Windows 项目应把执行载体换成目标平台命令。

package main

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

// lastValue 从后往前找，符合环境切片“最后一个同名键生效”的约定。
func lastValue(env []string, key string) string {
    prefix := key + "="
    for i := len(env) - 1; i >= 0; i-- {
        if strings.HasPrefix(env[i], prefix) {
            return strings.TrimPrefix(env[i], prefix)
        }
    }
    return ""
}

func main() {
    cmd := exec.Command("sh", "-c", `printf 'PWD=%s\nMODE=%s\n' "$PWD" "$MODE"`)

    // 先设工作目录，再整理环境，Unix 下 PWD 才能反映新的目录。
    cmd.Dir = "./sandbox"
    env := cmd.Environ()

    // 只改返回副本；写回 cmd.Env 才会传给子进程。
    env = append(env, "MODE=preview")
    cmd.Env = env
    fmt.Printf("待运行 MODE=%s\n", lastValue(cmd.Environ(), "MODE"))

    out, err := cmd.Output()
    if err != nil {
        // 这里同时覆盖启动失败和非零退出，生产代码可再区分 ExitError。
        panic(fmt.Errorf("执行命令: %w", err))
    }
    fmt.Print(string(out))
}

运行前准备目录：

# 让示例的工作目录真实存在；目录名由应用配置决定。
mkdir -p sandbox
# 在 Unix-like 系统中运行示例。
go run .

预期看到 待运行 MODE=preview，随后是子进程打印的 PWD 和 MODE。这里的输出是示例预期，不把未在读者机器上执行的结果冒充成运行证据。

覆盖变量时保留继承关系和最后值

如果直接写 cmd.Env = []string{"MODE=preview"}，就不再自然继承当前环境中的其他变量。更稳妥的做法是先取得 cmd.Environ()，再追加业务覆盖项。重复键不需要手工修改原切片的旧项，Go 的执行环境规则会采用最后一个同名键。

但“最后一个值生效”不代表所有变量都适合重复追加。对 PATH、代理地址或凭据类变量，先决定是覆盖、删除还是保留，再构造最终切片；不要把敏感值打印到日志。需要可审计时，只记录键名和是否存在，别记录完整值。

把环境检查和命令错误分开判断

调用 cmd.Environ() 只能证明当前配置被整理成什么样，不能证明程序一定能启动，也不能证明程序会正确消费变量。目录不存在、可执行文件不在 PATH、命令自身返回非零，都要看 Output 或 Run 的错误。

排查时按这个顺序更省时间：先打印非敏感的键名和值摘要；再确认 cmd.Dir 存在并且工作目录符合预期；最后执行命令并保留错误上下文。若只在调用前检查环境，却没有把切片写回 cmd.Env，检查通过也没有实际意义。

几个容易踩到的边界

• 调用顺序：需要新的 PWD 时，先设 Dir，再调用 Environ；不要复用旧快照。
• 平台差异：官方示例以 Unix 为主，Windows 对环境变量名和启动命令有自己的规则，跨平台代码要按目标系统测试。
• 安全范围：Environ 只负责环境构造，不是权限隔离；不要把用户输入未经约束地拼进 shell 命令。

Cmd.Environ 会启动子进程吗？

不会。它只是返回当前配置下将使用的环境切片，真正启动仍由 Start、Run 或 Output 完成。

修改 Environ 返回值为什么不生效？

返回值是副本。追加或删除后要执行 cmd.Env = env，之后再运行命令。

为什么设置 Dir 后 PWD 还是不对？

检查是否在设置 Dir 之前就保存了环境副本；同时注意 PWD 是 Unix 语义，Windows 不应把它当作统一契约。

把 Cmd.Environ 当作“执行前的环境检查点”即可：先确定工作目录，再从继承环境构造显式覆盖项，写回命令后执行，最后把配置检查与程序错误分开记录。