Python subprocess.run()函数env参数的作用是什么

核心规则 #

官方文档的表述可以拆成两个明确的行为边界：

• 当env使用默认值None时：新启动的子进程会默认完整继承当前Python进程的全部环境变量，和你直接在终端启动脚本拿到的环境一致。
• 当env传入非None的映射对象（通常是字典）时：子进程不会自动继承任何当前进程的环境变量，它运行时能读取到的所有环境变量，完全由你传入的映射决定，这个参数会直接透传给底层负责创建进程的Popen接口，由系统层面完成环境注入。

结合你的代码解释 #

你写的代码如下（注意运行前需要先导入os模块，否则会触发NameError）：

import subprocess as sp
foo= sp.run('bash ./foo_1/run_eval.sh foo_3.csv'.split(), env=os.environ.copy())

这段代码里传入的os.environ.copy()，是对当前Python进程环境变量做了一份浅拷贝，把这份拷贝作为子进程的环境传入。
这个写法和不传env参数的默认行为效果非常接近，但本质逻辑完全不同：

• 你是显式给子进程指定了一套和当前主进程完全一致的环境快照，而不是让子进程走默认的继承逻辑。
• 这种写法是自定义子进程环境的标准前置操作：你可以在传入前对这份拷贝做任意增删改，比如添加业务需要的自定义环境变量、修改PATH搜索路径、剔除不想暴露给子进程的敏感变量，这些修改只会作用在子进程中，完全不会影响当前Python主进程的环境。
  举个常见的定制示例：

import os
import subprocess as sp

# 基于当前环境做定制
custom_env = os.environ.copy()
custom_env["EVAL_BATCH_SIZE"] = "32"  # 给脚本加自定义参数
custom_env["PATH"] = "./third_party/bin:" + custom_env["PATH"]  # 追加可执行文件搜索路径
if "SECRET_TOKEN" in custom_env:
    del custom_env["SECRET_TOKEN"]  # 删掉敏感信息，避免子进程越权读取

# 用定制后的环境启动脚本
sp.run(["bash", "./foo_1/run_eval.sh", "foo_3.csv"], env=custom_env)

常见踩坑点 #

• 不要直接传env=os.environ不做拷贝：os.environ是和当前主进程环境绑定的特殊映射对象，直接传原对象会导致主进程和子进程共享环境引用，两边修改环境会互相干扰，触发很难排查的异常。
• 不要随意传入只包含少量自定义变量的空字典：如果传入的环境里没有PATH、HOME、LANG这类基础系统变量，子进程会找不到常用命令、读不到用户目录配置，大概率直接运行失败。

内容的提问来源于stack exchange，提问作者desert_ranger