VSCode中launch.json调用tasks.json后环境变量无法传递至Python测试的问题

你遇到的核心问题是：VS Code的preLaunchTask会在独立的shell进程中执行，导出的环境变量仅存在于该进程的生命周期内，无法自动传递到后续启动的Python调试进程——哪怕设置了panel: shared，这只是终端面板复用，进程本身还是相互隔离的。如果使用Poetry环境，由于它本身是独立的虚拟环境，更不会继承临时shell进程的变量。

以下是几种可行的解决方法，按推荐程度排序：

方法1：直接在launch.json中定义环境变量 #

这是最简单直接的方式，跳过shell脚本，直接在调试配置中注入变量：

{
    "name": "Python: Current File",
    "type": "python",
    "request": "launch",
    "program": "${file}",
    "console": "integratedTerminal",
    "justMyCode": true,
    "env": {
        "CONFIG_VALUE": "1234"
    }
}

Python调试进程会直接读取env字段中的变量，不管是否使用Poetry环境都能生效。

方法2：用脚本生成.env文件，在launch.json中加载 #

如果你的配置逻辑复杂（比如需要动态生成变量），可以让shell脚本把变量写入.env文件，再让VS Code调试配置加载这个文件：

1. 修改config.sh内容：

#!/bin/bash
# 将变量写入.env文件
echo "CONFIG_VALUE=1234" > "${workspaceFolder}/.vscode/.env"

2. 更新launch.json，添加envFile字段：

{
    "name": "Python: Current File",
    "type": "python",
    "request": "launch",
    "program": "${file}",
    "console": "integratedTerminal",
    "justMyCode": true,
    "preLaunchTask": "Export Configs",
    "envFile": "${workspaceFolder}/.vscode/.env"
}

这样调试进程会自动读取.env文件中的变量，同样支持Poetry环境。

方法3：让任务直接启动带变量的Python进程 #

如果必须通过shell脚本导出变量后再启动调试，可以修改tasks.json，让任务先加载配置再启动Python（或Poetry环境的Python）：

普通Python环境 #

{
    "label": "Export Configs and Run Python",
    "type": "shell",
    "command": "bash",
    "args": [
        "-c",
        "source .vscode/configs.sh && python ${file}"
    ],
    "group": {
        "kind": "build",
        "isDefault": true
    },
    "presentation": {
        "reveal": "always",
        "focus": true,
        "panel": "shared",
        "close": false
    }
}

直接运行这个任务即可，变量会在同一个shell进程中传递给Python。

Poetry环境 #

如果用Poetry，只需把命令改成：

{
    "label": "Export Configs and Run Python",
    "type": "shell",
    "command": "bash",
    "args": [
        "-c",
        "source .vscode/configs.sh && poetry run python ${file}"
    ],
    "group": {
        "kind": "build",
        "isDefault": true
    },
    "presentation": {
        "reveal": "always",
        "focus": true,
        "panel": "shared",
        "close": false
    }
}

若需要调试功能，可以结合debugpy在Python代码中启动调试，但这种方式不如前两种简洁。

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