VS Code 怎样为工作区配置独立环境变量

如果一个项目需要自己的端口、运行模式或 API 地址，不必把变量写进操作系统全局环境。VS Code 可以把配置放在当前工作区：终端变量写入项目的 .vscode/settings.json，只给某个任务使用的变量写入 tasks.json 的 options.env。

官方地址：https://code.visualstudio.com/

下面以 APP_MODE=workspace-dev 和 API_BASE=http://localhost:8080 为例。它们只是演示值，不要把真实密码、令牌或生产密钥提交到仓库。

先分清工作区设置和用户设置

打开项目文件夹后，按 ⇧⌘P（Windows/Linux 使用 Ctrl+Shift+P），执行 Preferences: Open Workspace Settings (JSON)。也可以直接在项目根目录建立 .vscode/settings.json。

工作区设置只对当前项目生效，并且会覆盖同名的用户设置；不要误打开 Preferences: Open User Settings (JSON)。在多根工作区中，设置仍要放在对应工作区的配置范围内。

在 settings.json 中配置集成终端变量

把下面内容放入 .vscode/settings.json。根据读者实际系统保留对应平台键；这里同时列出三个平台，方便项目成员共享同一份配置。

{
  // 这些变量只给当前工作区新建的集成终端使用
  "terminal.integrated.env.osx": {
    "APP_MODE": "workspace-dev",
    "API_BASE": "http://localhost:8080"
  },
  // Linux 使用 linux，Windows 使用 windows
  "terminal.integrated.env.linux": {
    "APP_MODE": "workspace-dev",
    "API_BASE": "http://localhost:8080"
  },
  "terminal.integrated.env.windows": {
    "APP_MODE": "workspace-dev",
    "API_BASE": "http://localhost:8080"
  }
}

保存后不要只看已经打开的旧终端：在终端面板点击新建终端，再从项目脚本或任务中读取变量。可见的成功状态是新终端显示工作区对应的模式，而不是用户级配置里的另一套值。

只给某个任务设置环境变量

如果变量不应该出现在每个集成终端里，可以把它收窄到 .vscode/tasks.json 的某一个任务。任务的 options.env 会传给该任务进程，适合构建、测试或本地启动命令。

{
  // 任务配置文件使用 2.0.0 格式
  "version": "2.0.0",
  "tasks": [
    {
      "label": "print-workspace-env",
      "type": "shell",
      "command": "node -e \"console.log(process.env.APP_MODE)\"",
      "options": {
        // 只给这个任务的子进程注入变量
        "env": {
          "APP_MODE": "workspace-dev"
        }
      },
      "problemMatcher": []
    }
  ]
}

执行 Terminal: Run Task，选择 print-workspace-env。任务输出为 workspace-dev 时，说明变量已经传给任务进程；它不会因此自动变成系统全局变量。

变量引用和常见边界

在 launch.json 或 tasks.json 支持的位置，可以使用 ${env:APP_MODE} 读取环境变量；${workspaceFolder} 表示当前工作区路径。不要把变量替换语法误当成任意 JSON 字段都支持的模板。

• 改完 terminal.integrated.env.* 后，新建终端再判断结果，旧终端可能仍保留启动时的环境。
• 变量写进 options.env 后，只对当前任务及其子进程可见，任务的命令、参数等字段不能都读取这个环境映射。
• 工作区文件可能进入 Git，真实密钥应使用安全的本地注入方式，并把敏感文件加入忽略规则。
• 远程窗口、容器或 WSL 的变量属于远端运行环境，不能简单等同于本机工作区的终端变量。

快速确认是否配置成功

最后按这三个点确认即可：第一，设置文件路径是当前项目的 .vscode/settings.json；第二，新建集成终端或运行目标任务后，输出能看到 workspace-dev；第三，关闭该项目并打开另一个项目时，另一个项目不会自动继承这组工作区变量。

相关问题：

• 为什么改了设置但终端里还是旧值？ 通常是复用了旧终端，关闭后新建一个终端再看。
• 任务变量和终端变量该怎么选？ 只服务一个构建或测试任务时用 options.env；需要让工作区新终端都可见时才用 terminal.integrated.env.。