debugpy调试模式下PowerShell子进程无法继承环境变量问题

问题场景 #

环境：

• Windows 22H2（版本19045.5487）
• Python 3.10.16
• debugpy调试环境

现象：

• 用subprocess.Popen()启动PowerShell时，正常执行能获取PROGRAMFILES、LOCALAPPDATA等核心环境变量；但debugpy调试模式下这些变量为空。
• 启动CMD执行echo %PROGRAMFILES%等命令时，无论是否调试都能正常继承环境变量。

该问题直接导致webdriver-manager无法在调试模式下检测Chrome版本。

测试验证情况 #

V1版本（shell参数默认/设为True） #

包含三种PowerShell启动方式：

1. 带-NoProfile参数
2. 不带-NoProfile参数
3. 显式传入env=os.environ.copy()
   调试模式下所有PowerShell调用均无法获取环境变量。

V2版本（shell参数设为False） #

调试模式下直接启动PowerShell触发FileNotFoundError；但手动通过Miniconda Prompt启动Python并附加debugpy时，执行正常。

原因分析 #

debugpy调试启动时的隔离流程，在Windows虚拟环境（如Miniconda）中，不会将系统级环境变量完整传递给PowerShell子进程——而CMD自身的环境加载机制能正常读取系统变量。当shell=False时，调试进程找不到PowerShell路径，也是因为PATH环境变量不完整导致的。

解决方案 #

1. 修改launch.json强制继承完整环境变量 #

在VS Code的.vscode/launch.json中，添加env字段直接继承所有系统环境变量：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "env": "${env:*}"
        }
    ]
}

如果需要精细化控制，也可以显式指定核心变量：

"env": {
    "PROGRAMFILES": "${env:PROGRAMFILES}",
    "LOCALAPPDATA": "${env:LOCALAPPDATA}",
    "PATH": "${env:PATH}"
}

2. 手动构造完整环境变量传入subprocess #

在调用subprocess.Popen()时，手动补充可能丢失的系统变量，确保PowerShell能拿到核心值：

import os
import subprocess

# 复制当前环境变量，补充系统级变量
full_env = os.environ.copy()
full_env.update({
    "PROGRAMFILES": os.path.expandvars("%PROGRAMFILES%"),
    "LOCALAPPDATA": os.path.expandvars("%LOCALAPPDATA%")
})

# 启动PowerShell时传入完整环境
proc = subprocess.Popen(
    ["powershell.exe", "-Command", "echo $env:PROGRAMFILES"],
    env=full_env,
    shell=False
)
proc.communicate()

3. Miniconda Prompt手动启动调试（临时 workaround） #

打开Miniconda Prompt，激活对应虚拟环境后，运行以下命令启动debugpy：

python -m debugpy --listen 5678 --wait-for-client your_script.py

再在VS Code的launch.json中配置远程调试连接到本地5678端口，这种方式下PowerShell能正常继承完整环境变量。

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