VS Code调试会话环境变量设置问题：FOO变量无法读取

架构老林

2026-8-8

解决VS Code Python调试环境变量不生效的问题

可能的原因及解决方法

1. 确认调试配置是否被正确选中

右上角调试按钮启动时，要确保当前选中的是你配置的**"Python: Current File"**调试项。点击调试面板的下拉菜单，检查是否选中对应配置，避免启动了其他未设置FOO变量的调试任务。

2. 检查launch.json的位置

确保你的launch.json文件位于当前工作区的.vscode文件夹下，而非全局用户设置的.vscode目录。只有工作区目录下的配置才会对当前项目生效。

3. 改用安全方式读取变量排查问题

避免直接用os.environ["FOO"]抛出异常，先改用以下方式确认变量是否存在：

import os
print(os.getenv("FOO"))  # 变量未设置时返回None，不会触发KeyError

如果返回None，说明变量确实未被注入；如果返回BAR，则是之前读取方式的问题（该情况概率极低）。

4. 检查环境变量继承情况

VS Code调试默认会继承终端环境变量，若终端中存在同名FOO变量且值为空，可能会覆盖配置里的设定。可以尝试在launch.json中添加.env文件管理变量（可选）：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "justMyCode": true,
            "env": {
                "FOO": "BAR"
            },
            "envFile": "${workspaceFolder}/.env"
        }
    ]
}