VS Code 怎么为不同项目设置不同的调试环境变量

如果两个项目都按 F5 启动，却读到了同一个 APP_MODE 或接口地址，先不要去改系统环境变量。更稳妥的做法是把调试变量放进各自工作区的 .vscode/launch.json，再从运行和调试视图选择对应配置。这样项目 A 和项目 B 可以拥有不同的变量、工作目录和启动参数，切换项目时不会靠记忆手动改值。

先把变量放进项目自己的 launch.json

先用 VS Code 打开项目文件夹，点击左侧运行和调试图标，选择“创建 launch.json 文件”，再选择项目对应的调试环境。VS Code 会在工作区根目录创建 .vscode/launch.json；之后可以在配置下拉框中切换不同的启动方案。

以一个本地 API 项目为例，下面这段配置只放演示值，不放真实密钥：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch API - local",
      "program": "${workspaceFolder}/src/server.js",
      "cwd": "${workspaceFolder}",
      "env": {
        // 中文说明：这些值只服务于当前调试配置
        "APP_MODE": "local",
        "API_BASE_URL": "http://127.0.0.1:4100"
      }
    }
  ]
}

这里最容易混淆的是“终端变量”和“调试进程变量”。env 作用于这条 launch 配置启动的程序，不等于替你修改了操作系统环境。cwd 则把程序工作目录固定在当前项目，避免相对路径随着启动方式变化。

用不同配置区分不同项目和运行场景

如果同一项目有本地、测试两种后端地址，可以在 configurations 中放两项，而不是每次覆盖同一项：

{
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "API - local",
      "program": "${workspaceFolder}/src/server.js",
      "env": {
        // 中文说明：本地调试使用本机服务地址
        "APP_MODE": "local",
        "API_BASE_URL": "http://127.0.0.1:4100"
      }
    },
    {
      "type": "node",
      "request": "launch",
      "name": "API - test",
      "program": "${workspaceFolder}/src/server.js",
      "env": {
        // 中文说明：测试配置只改变调试目标，不改代码入口
        "APP_MODE": "test",
        "API_BASE_URL": "https://test.example.invalid"
      }
    }
  ]
}

选择配置时看名称，不要只看当前文件。VS Code 支持 ${workspaceFolder}、${env:NAME} 等变量替换；多根工作区还可以写成 ${workspaceFolder:Api}，明确引用名为 Api 的根目录。路径中有空格时，把它作为一个数组元素传给 args，不要额外套一层引号。

变量较多时改用 envFile，并留好安全边界

当变量超过几项，直接堆在 launch.json 会让配置难读，可以把本地调试值放到项目目录的 .env.local：

{
  "type": "node",
  "request": "launch",
  "name": "API - local env file",
  "program": "${workspaceFolder}/src/server.js",
  // 中文说明：路径跟随当前工作区，避免机器绝对路径
  "envFile": "${workspaceFolder}/.env.local",
  "cwd": "${workspaceFolder}"
}

把包含密码、令牌或个人服务地址的文件加入忽略规则，不要提交到共享仓库。团队可以提交 .env.example 说明变量名和格式，但把真实值留在本机。还要留意具体调试扩展对 envFile 的支持和覆盖规则；看到变量不生效时，优先查看该调试器的配置说明。

启动后用调试面板确认变量属于当前项目

在运行和调试视图选择目标配置，按 F5 启动。程序停在断点后，展开右侧 VARIABLES，或者在 Debug Console 查看进程实际读到的值。图中用绿色状态表示已经暂停在断点，变量区同时显示当前配置对应的模式和地址。

这一步比“看起来配置保存了”更可靠：只有调试进程实际读到当前项目的值，配置才完成闭环。

常见问题

每个项目都要创建 launch.json 吗？

不一定。简单程序可以直接运行当前文件；只要需要项目变量、工作目录或多套启动方案，就建议把配置保存到项目自己的工作区文件中。

能不能把变量写进 settings.json？

不要把调试进程变量当成普通编辑器设置。调试配置应放在 launch.json 的对应 configuration 中，具体字段是否可用仍以所用调试扩展的文档为准。

多根工作区为什么会拿错路径？

因为变量默认按所属根目录解析。使用 ${workspaceFolder:根目录名} 明确作用域，并给每项配置写清 cwd，通常就能避免根目录混用。

归纳一下：项目级配置解决“不同项目不同变量”，多 configuration 解决“同项目多环境”，envFile 解决“变量较多”，而 VARIABLES 面板解决“确认是否真的生效”。把这四件事连起来，VS Code 的 F5 调试就不会再依赖手动改全局环境。