VS Code 调试配置怎么让环境变量只对当前启动生效

如果只是临时把调试环境切到 staging，没必要先改终端的全局环境变量。把变量写进 .vscode/launch.json 某一个 launch 配置的 env 对象，再从 Run and Debug 选择它，变量就会跟着这次启动进入调试进程；停止会话后，不会自动改写系统环境，也不会影响同文件里的其他配置。

步骤一：从 Run and Debug 打开当前工作区配置

先用 VS Code 打开项目文件夹，而不是只打开一个孤立文件。点击左侧活动栏的 Run and Debug，首次使用时选择 Create a launch.json file，再选择项目对应的调试器；已经有配置的项目直接打开工作区内的 .vscode/launch.json。

在配置下拉框中先选一个容易辨认的名称，例如 Launch: Local Debug。VS Code 官方说明中，复杂调试场景的配置保存在工作区 .vscode 文件夹，配置列表也来自 launch.json；因此这一步的关键不是马上按 F5，而是确认当前工作区和当前配置都选对。

可见确认：Explorer 中能看到 .vscode/launch.json，Run and Debug 面板顶部的下拉框显示目标配置名称，且没有 JSON 红色波浪线。

步骤二：把变量放进当前 launch 配置

把光标放到 configurations 数组中的目标对象里，加入 env。下面的示例只让名为 Launch: Local Debug 的启动项使用 staging 和 debug 值：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch: Local Debug",
      "program": "${workspaceFolder}/src/server.js",
      "env": {
        "API_MODE": "staging",
        "LOG_LEVEL": "debug"
      }
    }
  ]
}

这里的 JSON 不放注释，以免破坏配置文件语法；阅读时只需抓住层级：env 和 program 同属一个启动对象，变量名是键，启动时要传入的值是字符串。不同调试器支持的属性会有差异，输入 type 后可以用 IntelliSense 查看当前扩展提供的字段。

可见确认：env 出现在目标配置的花括号内部，API_MODE 和 LOG_LEVEL 的值紧邻变量名显示；另一个配置如果没有这两个字段，就不会因为这里的编辑而获得同样的值。

步骤三：用指定配置启动并确认会话状态

回到 Run and Debug 面板，点击顶部配置下拉框，选择 Launch: Local Debug，再点击 Start Debugging 的播放按钮，或者按 F5。VS Code 文档把 F5 和 Run and Debug 视图列为启动调试会话的入口；会话开始后，Debug Console 会出现，状态栏也会显示当前调试状态。

如果程序在断点停住，可以在 VARIABLES 面板展开进程相关变量，或打开 Debug Console 做与调试器兼容的表达式检查。不要只看“程序启动了”就下结论，实际确认应同时包括选中的配置名和程序读取到的变量值。

可见确认：顶部仍显示 Launch: Local Debug，调试工具栏处于活动状态，Debug Console 有本次会话输出，Variables 中能看到 API_MODE=staging 和 LOG_LEVEL=debug。停止调试后再从普通终端启动一次，若没有在那里设置同名变量，终端进程不应凭空继承这两个值。

步骤四：为不同环境复制配置并处理边界

需要本地和 staging 两套值时，可以复制一个配置对象，分别命名为 Launch: Local 和 Launch: Staging，只改各自的 env。这种方式比每次手改同一个对象更不容易把错误环境带进下一次启动。要清除继承到的变量，部分调试器支持把对应值设为 null，但最终仍以调试扩展的属性说明和 IntelliSense 提示为准。

变量很多时可改用 envFile 指向 dotenv 文件。它解决的是“配置太长”的维护问题，不等于自动解决密钥安全问题：不要把真实令牌提交到公共仓库，建议提交脱敏示例文件，并把真实文件加入项目的忽略规则。

最终验收可以按三项完成：第一，选中的配置名与预期环境一致；第二，断点或 Debug Console 能确认调试进程读到了目标变量；第三，停止调试并换普通启动方式后，临时变量没有被写入系统或终端的长期环境。

常见问题

为什么 launch.json 里写了 env，程序还是读不到？

先确认字段位于具体配置对象内，再确认 Run and Debug 下拉框选的是这一个配置；如果仍无效，检查 type 对应的调试扩展是否支持 env，以及变量名是否与程序读取的名称完全一致。

env 和 envFile 应该怎么选？

变量少、希望一眼看到时用 env；变量多或需要本地文件管理时用 envFile。两者都属于启动配置，不能因此把密钥直接提交进仓库。

停止调试后，环境变量会自动清除吗？

由 launch.json 注入的值属于该调试进程的启动配置，停止会话不会把它写回系统环境。若你曾手动修改终端配置文件或系统变量，那部分修改需要单独撤销。