Go 子进程没有继承环境变量的 Cmd.Env 处理

Go 子进程默认会继承父进程环境；最容易把继承切断的写法，是把 Cmd.Env 设为只含新增变量的切片。需要“继承并覆盖”时，我会先设置 Cmd.Dir，再使用 append(cmd.Environ(), "KEY=value")。如果变量在父进程里就不存在，追加环境快照也不能把它找回来。

我把这个问题看成任务执行器的一项配置选择：是尽量复用服务环境，还是显式限制子任务能看到什么？下面以一个自行启动副本的 Go 程序解释取舍，不假定已经发生过某次线上事故，也不展示未执行的运行日志。

官方文档入口：https://pkg.go.dev/os/exec。本文示例使用 Cmd.Environ，要求 Go 1.19 或更新版本；操作系统的环境细节仍应以目标平台为准。

先确定子进程需要哪一类环境

如果任务依赖父进程已有的配置、工具搜索路径与地区设置，保留继承通常更省配置工作。如果任务的输入必须严格可控，最小环境更合适，但也意味着需要自行提供程序真正依赖的变量。我不建议在还没确定约束时直接清空全部环境，再逐个补到“不报错为止”。

一个重要区别是：nil 切片与非 nil 空切片都满足长度为零，但配置含义不同。后者表达显式空环境，而不是继承。不过不要把“空”理解为所有操作系统绝无任何补充项；例如 Windows 的 SYSTEMROOT 有官方文档说明的特殊处理。

另一个让我倾向于子任务局部配置的原因，是并发请求共享父进程环境。为任务 A 调用 os.Setenv，再为任务 B 改回去，会把业务配置范围扩大到整个进程。通常应为每个 Cmd 构造自己的 Env，避免请求之间相互影响。

把 Dir 放在环境快照之前

Cmd.Dir 是子进程的工作目录，不是加载环境文件的开关。设置目录不会自动读取 .env、shell 配置或用户登录脚本。把工作目录移到项目目录，只能解决依赖相对路径的那部分问题。

在使用 PWD 的平台上，Dir 与环境里的 PWD 存在关联。因此我会先确定 Dir，再调用 cmd.Environ。反过来先保存环境，再改变目录，容易把已经显式保存的旧 PWD 一并带过去。实际目录与某个普通变量的字符串值也不能混为一谈。

若问题只在定时任务或服务中出现，我会先查看该 Go 父进程通过 os.LookupEnv 是否能看见指定键，而不是在另一个交互终端执行 echo。终端里设置的变量不等于服务管理器启动的进程也有同样变量。诊断时只报告键是否存在，不打印整份环境。

用自启动探针观察指定变量

下面的完整示例不调用 shell，也不依赖系统 env 命令。父程序找到自身可执行文件，并通过一个固定参数进入子进程探针分支。这样既能观察 Cmd.Env，也能减少 PATH 和 shell 启动方式带来的干扰。

package main

import (
    "context"
    "encoding/json"
    "fmt"
    "os"
    "os/exec"
    "time"
)

type observation struct {
    Present bool   `json:"present"`
    Value   string `json:"value"`
    Dir     string `json:"dir"`
}

func main() {
    if err := run(); err != nil {
        // 只报告错误，不输出整个环境或外部程序的敏感日志。
        fmt.Fprintln(os.Stderr, err)
        os.Exit(1)
    }
}

func run() error {
    if len(os.Args) == 2 && os.Args[1] == "--env-probe" {
        // 子进程仅报告演示变量，不枚举凭据等其他环境。
        value, present := os.LookupEnv("DEMO_TASK_MODE")
        dir, err := os.Getwd()
        if err != nil {
            return err
        }
        return json.NewEncoder(os.Stdout).Encode(observation{present, value, dir})
    }

    self, err := os.Executable()
    if err != nil {
        return err
    }
    dir, err := os.Getwd()
    if err != nil {
        return err
    }
    // 仅此独立演示程序设置父环境，服务中不要按每个请求改全局环境。
    if err := os.Setenv("DEMO_TASK_MODE", "parent-demo"); err != nil {
        return err
    }
    for _, mode := range []string{"inherit", "replace", "merge"} {
        ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
        cmd := exec.CommandContext(ctx, self, "--env-probe")
        cmd.Dir = dir
        switch mode {
        case "inherit":
            // Env保持nil，继承父进程当前环境。
        case "replace":
            // 非nil列表是完整配置，不会自动补回父进程变量。
            cmd.Env = []string{"DEMO_OTHER_FLAG=1"}
        case "merge":
            // 先设置Dir，再取得快照；同名变量最后一项生效。
            cmd.Env = append(cmd.Environ(), "DEMO_TASK_MODE=child-demo")
        }

        out, runErr := cmd.Output()
        cancel() // 每轮结束即释放计时器，不在循环里堆积defer。
        if runErr != nil {
            return fmt.Errorf("%s: %w", mode, runErr)
        }
        var got observation
        if err := json.Unmarshal(out, &got); err != nil {
            return fmt.Errorf("%s: invalid probe response: %w", mode, err)
        }
        fmt.Printf("%s present=%t value=%q dir=%q\n",
            mode, got.Present, got.Value, got.Dir)
    }
    return nil
}

可将它保存为 main.go 后，在自己的开发环境执行 go run main.go。本文未运行该程序；按配置语义，inherit 应看到 parent-demo，replace 应报告指定演示键不存在，merge 应看到 child-demo。目录输出取决于读者运行位置，不应与某个固定路径比对。

这个探针还区分了“变量不存在”和“变量存在但值为空”：使用 LookupEnv 的布尔结果，而不是只看 Getenv 的空字符串。为了演示稳定，程序仅设置一个独立演示键；生产服务应从其启动配置读取基础环境，再为 Cmd 增加任务级覆盖。

绝对可执行路径也有实际价值。exec.Command 接到不带路径的程序名时会进行路径查找；事后修改 cmd.Env 中的 PATH，不能据此断言它会重新选择另一个可执行文件。若依赖特定工具，使用已确定的路径，比让配置值、工作目录和查找环境一起变化更容易解释。

输出不见了，不一定是环境丢了

当探针没有可见输出时，我会先区分它没启动、非零退出，还是输出没有被接住。单独调用 Run 且没有设置 Stdout、Stderr，不会自动把它们展示到父进程终端。Output 适合本文这种少量、结构化的标准输出；CombinedOutput 适合短小诊断文本，但会把错误流混在一起，不适合直接当纯 JSON 解码。

长期运行、持续产生日志的程序不应无上限地把输出积存在内存。需要流式处理时可以选择 StdoutPipe；它要求启动进程后及时读管道，并在读取完成后再 Wait。不要一边使用 StdoutPipe，一边调用 Run；若还创建了 StderrPipe，应同时消费错误流，避免某一边写满后阻塞。

本文的短探针只需要 Output，因此没有增加管道和读取协程。若工具会输出大量错误日志，可把 Stderr 直接交给受控 Writer，或者并行消费两个管道；无论哪种方案，输出处理都不应该被误判成环境继承规则变化。

我会保留的部署约束与相关问题

对于可信的内部批处理工具，我倾向于保留继承，再覆盖少量业务键，兼容成本较低。对于需要限制环境可见范围的任务，我会显式列出所需键，并在目标操作系统检查运行依赖；这不是只改一行 Env 就能获得的进程隔离。环境白名单也不能代替权限和资源限制。

部署记录可以只保留：父进程是否具有目标键、使用哪种 Env 策略、Dir 是否存在、可执行路径是否明确、输出采用哪种接收方式以及启动错误。密钥值与整份环境不属于必要日志。

为什么追加 "KEY=value" 后旧值还在？检查是否真正赋回 cmd.Env，以及是否启动了另一个 Cmd。官方约定同名键由列表中最后一项生效；不要用手写 map 的随机遍历顺序来解释重复键覆盖。

为什么 $KEY 原样传给子程序？os/exec 不自动调用 shell，也不展开变量。参数需要什么值，就显式构造那个参数；不要为了变量展开而把不可信输入拼接到 shell 命令里。

目录正确但配置仍未加载怎么办？先查目标工具是否自行支持环境文件。Cmd.Dir 本身不负责读取配置文件，Cmd.Environ 也不是 .env 解析器。

参考：Go os/exec：Cmd、Environ 与输出接口；Go os：LookupEnv 与父进程环境；Go os/exec 官方实现。