Go exec.Cmd.Environ 为什么读不到刚设置的环境变量

问题通常不在 exec.Cmd.Environ 没有刷新，而在于它返回的是一份副本。如果先把这份副本保存到 env，再修改 cmd.Env，继续打印旧的 env 自然看不到新变量。正确做法是先完成 cmd.Env 的构造，最后重新调用 cmd.Environ() 做检查；需要继承父进程环境时，则从 cmd.Environ() 或 os.Environ() 复制后再追加。

先区分 Environ 返回值与 cmd.Env 字段

Cmd.Environ 的定位是“命令按当前配置启动时会使用什么环境”的读取方法，而且返回的是 copy。下面这个例子故意保留了常见误区：

package main

import (
	"fmt"
	"os/exec"
)

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

	// 这里拿到的是当时的环境副本，不是会自动联动的引用。
	envBefore := cmd.Environ()
	cmd.Env = append(envBefore, "APP_MODE=staging")

	// 旧副本仍然是旧状态；必须重新读取 Cmd 的当前配置。
	fmt.Println("旧副本是否包含 APP_MODE：", contains(envBefore, "APP_MODE="))
	fmt.Println("最终配置是否包含 APP_MODE：", contains(cmd.Environ(), "APP_MODE="))
}

func contains(env []string, prefix string) bool {
	// 用前缀检查只为演示快照，不把环境值写死在判断逻辑里。
	for _, item := range env {
		if len(item) >= len(prefix) && item[:len(prefix)] == prefix {
			return true
		}
	}
	return false
}

这里的两个判断结果不同是正常的：envBefore 保存了追加前的状态，cmd.Env 才是随后要传给子进程的配置。若需要看到变量值，直接遍历重新调用得到的 cmd.Environ()，不要复用之前保存的切片。

按继承需求初始化环境变量

另一个容易混淆的点是 cmd.Env 的零值语义。它为 nil 时，子进程使用当前进程环境；一旦显式设置为非 nil 切片，子进程只使用这份切片。因此，直接从空切片追加虽然能设置变量，却可能丢掉 PATH 等原有配置。

package main

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

func main() {
	cmd := exec.Command("sh", "-c", "printf 'mode=%s\\npath=%s\\n' \"$APP_MODE\" \"$PATH\"")

	// 从父进程环境复制，再追加子进程专用值，避免把 PATH 等变量清空。
	cmd.Env = append(cmd.Environ(), "APP_MODE=staging")

	// 配置完成后重新读取最终副本；os.Environ 也可用于同样的继承式初始化。
	for _, item := range cmd.Environ() {
		if strings.HasPrefix(item, "APP_MODE=") {
			fmt.Println("将传入子进程：", item)
		}
	}

	_ = os.Environ // 说明 os.Environ 是当前进程环境的另一种起点
	if err := cmd.Run(); err != nil {
		// 真实项目中应保留启动或退出错误，便于区分环境问题与命令问题。
		panic(err)
	}
}

如果你的目标就是完全隔离环境，也可以显式写成 cmd.Env = []string{"APP_MODE=staging"}，但这时不要再期待父进程的变量存在。命令本身依赖外部可执行文件时，优先使用继承式写法，排查成本更低。

用最后一个同名键覆盖旧值

环境变量不是 Go 的 map，列表中可以暂时出现同名项。os/exec 在处理命令环境时会按键去重，并采用后面出现的值。于是“我明明刚设置了变量却读到旧值”还可能是追加顺序的问题：

package main

import (
	"fmt"
	"os/exec"
)

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

	// 两个同名项同时存在时，后一个 staging 才是最终值。
	cmd.Env = append(cmd.Environ(), "APP_MODE=dev", "APP_MODE=staging")

	for _, item := range cmd.Environ() {
		if len(item) >= len("APP_MODE=") && item[:len("APP_MODE=")] == "APP_MODE=" {
			fmt.Println(item)
		}
	}
	if err := cmd.Run(); err != nil {
		// 运行失败时先保留原始错误，不要把它误判成 Environ 未刷新。
		panic(err)
	}
}

工程代码里更稳妥的习惯是：构造环境、覆盖同名键、再读取一次最终快照。不要只看最早保存的 env，也不要把 cmd.Env 当成可直接按键索引的 map。

在启动前检查最终快照并运行命令

可以把排查顺序固定为四步：先确定是否需要继承；再修改 cmd.Env；然后调用一次新的 cmd.Environ() 打印目标键；最后调用 Run、Output 或 Start。这样日志看到的配置与子进程启动时使用的配置来自同一阶段。

package main

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

func main() {
	cmd := exec.Command("sh", "-c", "printf 'APP_MODE=%s\\n' \"$APP_MODE\"")
	// 所有 Env 修改放在启动前；Environ 只负责读取当前命令配置的副本。
	cmd.Env = append(cmd.Environ(), "APP_MODE=staging")

	finalEnv := cmd.Environ()
	for _, item := range finalEnv {
		if strings.HasPrefix(item, "APP_MODE=") {
			fmt.Println("启动前检查：", item)
		}
	}

	out, err := cmd.Output()
	if err != nil {
		// Output 的错误可能来自启动失败或非零退出，要和环境值分开诊断。
		panic(err)
	}
	fmt.Print(string(out))
}

这个示例中，启动前检查会看到 APP_MODE=staging，子进程也会输出同样的值。注意 Cmd 在成功调用 Start、Run、Output 或 CombinedOutput 后不能复用；需要不同环境时重新创建命令对象。

常见问题

为什么 cmd.Env = append(cmd.Env, "KEY=value") 后环境变少了？
因为 cmd.Env 原本是 nil，直接追加会得到只含新项的非空切片；需要继承时改用 append(cmd.Environ(), "KEY=value")。

修改 cmd.Env 后应该打印哪个变量？
打印修改后重新调用 cmd.Environ() 的结果。之前保存的返回切片是独立副本，不会因为字段赋值而更新。

同名变量出现两次，哪个值传给子进程？
后出现的值生效。调试时检查最终快照，必要时在构造阶段主动去重，避免调用链中多次追加造成误判。