开发工具 JetBrains 运行环境变量 怎样处理

JetBrains IDE 里的运行环境变量，应该配置在实际启动项目的 Run/Debug Configuration 中，而不是随手写进程序参数或 VM options。最稳妥的做法是：先选中要运行的配置，再在 Environment variables 中添加变量；变量较多时用编辑器、.env 文件或环境脚本管理。这样每个运行配置都能拥有清晰、可复现的运行环境。

官方地址：https://www.jetbrains.com/help/idea/program-arguments-and-environment-variables.html

Go 配置补充：https://www.jetbrains.com/help/idea/go-plugin-run-debug-configurations.html

先分清环境变量、程序参数和 VM 选项

这三个位置都在运行配置里出现，但传递对象不同。环境变量会进入被启动进程的环境；程序参数会出现在应用收到的命令行参数中；VM options 则传给 Java 虚拟机。把同一个值填错位置，程序可能不会报错，只是一直读取不到预期值。

如果项目是 Go，Go 插件的运行配置同样提供 Environment 字段；官方说明中还会出现 Run kind、Working directory、Program arguments 和 Go tool arguments 等字段。先确认你打开的是 Go、Application、Maven 或其他实际启动类型，因为不同配置模板的字段位置和可用性可能不同。

从 Run/Debug Configurations 找到正确入口

在顶部运行组件的下拉菜单中选择 Edit Configurations，然后打开真正负责启动项目的配置。也可以使用菜单 Run | Edit Configurations。如果当前只是临时运行，建议先把它保存为永久配置，否则切换运行目标后可能找不到刚才添加的变量。

选好配置后，找到 Environment variables 字段。少量变量可以直接输入，例如 APP_MODE=development;LOG_LEVEL=debug；变量较多时点击编辑按钮，以表格方式逐项维护。字段旁边没有 Environment variables，通常不是变量功能消失，而是当前配置类型把它放在了另一个区域，或需要先展开更多选项。

按变量数量选择直接填写还是编辑表格

临时排查一个变量时，直接填写最快。需要长期运行的项目则建议打开变量编辑窗口，每行维护一个名称和值，避免分号、空格或复制粘贴造成的格式错误。示例值可以这样组织：

# 仅示例：这些值绑定到当前运行配置，不要放入真实密钥
APP_MODE=development
API_BASE_URL=https://api.example.test
LOG_LEVEL=debug

这里的 API_BASE_URL 只是示例变量名，实际名称必须与程序读取的名称完全一致。不要把访问令牌、密码或生产数据库地址直接写进会提交到仓库的共享配置；本地运行可以使用未纳入版本控制的文件，团队共享时只共享变量名和安全的默认值。

变量较多时使用 .env、脚本和父环境

官方文档给出了三种扩展方式。第一种是打开编辑窗口，手动维护多行变量；第二种是在 Environment variables 字段中指定 .env 文件或脚本路径；如果有多个文件，路径之间用分号分隔。第三种是引用启动 IDE 的父环境变量，格式为 $VAR$，例如在 macOS/Linux 中可写成 PATH=./bin:$PATH$，Windows 的变量名大小写也要按实际环境保持一致。

环境脚本可以使用 set VAR=value 或 export VAR=value 设置变量。脚本产生的环境只用于对应配置的一次启动，并且会覆盖自定义值，所以不要同时在表格和脚本里维护同名变量。若出现“明明填了值却不是这个值”，优先检查是否存在脚本或父环境覆盖。

保存并按顺序排查变量不生效

1. 确认顶部运行组件选中的名称，就是刚才编辑的配置；不同配置可以有同名变量但值不同。
2. 检查变量名是否与代码读取的名称完全一致，包括大小写、下划线和前后空格。
3. 检查是否把值放到了 Program arguments 或 VM options；这两个位置不会自动变成进程环境变量。
4. 检查 .env 路径、脚本路径和工作目录；相对路径通常应该以当前运行配置的工作目录为基准。
5. 如果同时使用表格、父环境和脚本，先暂时只保留一个来源，确认读取结果后再逐项恢复。

确认配置后点击 Apply 或 OK 保存，再重新启动运行配置。需要团队复用时，可以启用 Store as project file，把运行配置保存为项目文件并通过版本控制共享；敏感值仍应留在本地文件或安全的外部注入系统中。不要把一个人的绝对路径、个人账号或真实密钥提交给团队。

常见问题

为什么在系统终端里能读到变量，JetBrains 运行时却读不到？

IDE 启动时继承的父环境与终端不一定相同，而且运行配置还可能覆盖或替换变量。把变量明确添加到当前 Run/Debug Configuration，或确认 .env/脚本已绑定到该配置。

多个运行配置能共用一份环境变量吗？

可以通过同一个 .env 文件或环境脚本复用，但每个运行配置仍要单独设置来源。共享配置时只提交不敏感内容，真实密钥留在本地或受控注入渠道。

环境变量和 VM options 中的系统属性是一回事吗？

不是。环境变量属于进程环境，VM options 是传给 Java 虚拟机的启动参数。除非程序明确做了转换，否则两者不能互相替代。