IDE Run Configuration 怎样保存环境变量

可以把环境变量保存到 IDE 的 Run Configuration 中。以 VS Code 为例，项目级调试配置通常放在 .vscode/launch.json，直接写入的非敏感变量放进 env，只适合本机的变量放进外置 envFile。启动时选择这条配置，IDE 就会把变量注入本次运行的进程，不需要每次重新输入。

官方地址：https://code.visualstudio.com/docs/debugtest/debugging-configuration

本文用“同一个项目需要开发模式和本机数据库地址”的场景说明操作路径。文中界面图是原创操作示意图，不是 VS Code 的实际截图；示例中的密钥只使用占位符。

先决定变量应该保存在哪里

Run Configuration 保存的是“启动这一次应用时怎样准备环境”。它和系统环境变量、IDE 集成终端变量不是同一层。先按下面的边界拆开，后面才不会出现“配置写了但启动读不到”或“把密钥提交进仓库”的问题。

VS Code 官方调试配置文档把 env 和 envFile 列为调试器可能支持的属性，但具体字段仍由所选调试器决定。也就是说，看到红色波浪线时，先检查当前 type 对应的扩展是否支持该字段。

从 Run and Debug 创建项目级配置

1. 用 VS Code 打开项目文件夹，不要只打开单个文件。项目级配置需要一个工作区根目录。
2. 点击左侧 Activity Bar 的 Run and Debug，或者使用默认快捷键 Ctrl+Shift+D；macOS 可以使用 Shift+Command+D。
3. 在面板中点击 create a launch.json file，再选择与项目匹配的调试器。VS Code 会在项目的 .vscode 目录创建并打开 launch.json。

这一步的关键不是记住某个按钮，而是确认配置归属：放在项目 .vscode/launch.json 的配置可以随项目一起被团队看到；用户级配置则更适合个人通用启动方案。本文选择项目级配置，便于让启动入口和公共开发开关保持一致。

在 launch.json 中保存 env 和 envFile

假设应用需要 APP_MODE、LOG_LEVEL 和一个只在本机使用的数据库地址，可以把公共开关写进 env，把本机文件路径写进 envFile。下面的 JSON 保持有效格式，字段含义写在代码块旁边，不在严格 JSON 中插入注释。

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Project Run Setup",
      "type": "node",
      "request": "launch",
      "program": "${workspaceFolder}/src/index.js",
      "cwd": "${workspaceFolder}",
      "env": {
        "APP_MODE": "development",
        "LOG_LEVEL": "info"
      },
      "envFile": "${workspaceFolder}/.env.local"
    }
  ]
}

name 是运行配置下拉框里显示的名称；program 和 cwd 决定启动入口与工作目录；env 是直接写在配置里的键值；envFile 则指向外部变量文件。不同语言调试器的入口字段可能不同，不能把 Node.js 的 program 原样搬到 Python 或其他扩展中。

.env.local 可以只保存在本机，例如：

# 仅用于本机调试的变量，不把真实凭据提交到仓库
DATABASE_URL=postgres://127.0.0.1:5432/demo
SECRET_KEY=

这段文件名只是示例，实际支持的 env 文件格式和优先级由调试器扩展决定。把它加入项目的忽略规则，并在仓库里提供一个只含变量名的模板文件，通常比把真实值写进 launch.json 更稳妥。

选择配置并确认变量真的注入

1. 回到 Run and Debug 面板，在配置下拉框中选择 Project Run Setup。
2. 点击 Start Debugging 或按 F5。如果需要先构建项目，可以在配置中加入调试器支持的 preLaunchTask。
3. 在应用自己的启动日志、调试变量面板或安全的诊断页面中确认模式和日志级别已生效。不要为了确认密钥而把密钥打印到日志。

如果应用读到的是空值，按顺序检查四件事：配置下拉框是否选对、envFile 的路径是否相对当前工作区、调试器是否支持这个字段、应用读取变量的名称是否完全一致。尤其要注意，启动调试进程和打开一个新的集成终端并不是同一个动作；终端里能读到变量，不代表调试器一定会继承它。

常见问题

为什么保存了 launch.json，运行时还是没有变量？

先看当前配置是否真的被选中，再检查 type 对应的扩展文档。VS Code 的通用配置支持范围和具体调试器属性不是一回事；字段不受支持时，编辑器通常会提示配置问题。

env 和 envFile 能同时使用吗？

可以在配置中同时声明，但合并规则和同名变量的优先级应以当前调试器文档为准。为了减少歧义，同一个变量最好只在一个位置提供，公共开关放 env，本机值放外置文件。

把 .env.local 放进项目后，团队成员能直接运行吗？

如果文件被忽略，其他成员通常不会自动拥有它。建议提交 .env.example 之类的变量名模板，再让每个人在本机创建真实的 env 文件。

这会改变系统环境变量吗？

不会。Run Configuration 主要影响它启动的调试进程；系统设置、其他终端和其他 IDE 配置不会因为保存了这条运行配置而自动改变。

最后确认

IDE Run Configuration 保存环境变量的可靠路径是：打开项目 → 进入 Run and Debug → 创建项目级 .vscode/launch.json → 用 env 保存非敏感公共值 → 用 envFile 引入本机值 → 选择配置启动并检查应用行为。配置文件解决的是“每次怎样启动”，不等于凭据存储；真实密钥仍应留在本机安全位置或专门的凭据系统中。