JetBrains IDE 配置运行配置读取环境文件的操作步骤

JetBrains IDE 读取项目环境文件，关键不在于把 .env 放进项目目录，而在于把它绑定到实际使用的 Run Configuration。打开 Run | Edit Configurations，在目标配置的 Environment variables 字段中选择 .env 文件，保存后再运行验证即可。不同配置类型的字段位置可能略有差异，但入口和判断方法一致。

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

步骤一：准备 .env 文件并对齐变量名

在项目根目录建立 .env，先用无敏感信息的变量验证链路，例如 APP_ENV=dev、API_BASE_URL=https://api.example.test。文件名可以按团队约定调整，但后面选择的路径必须指向同一个文件。变量名要和程序读取的键完全一致，大小写、下划线都不要凭感觉修改。

这里的文件只是本地启动输入，不等同于 IDE 的全局环境变量。真实密码、令牌和生产地址应放在安全的本地凭据或受控配置中，并把 .env 加入忽略规则。

步骤二：进入正确的 Run Configuration

在 JetBrains IDE 顶部运行配置下拉框中，先确认选中的是要启动的配置，然后点击 Run | Edit Configurations。左侧选择已有的 Application、Spring Boot、Maven、Shell Script 或项目实际使用的其他配置；不要只修改临时配置后又切回另一项。

如果列表中没有目标配置，可以点击工具栏的添加按钮创建对应类型。打开后重点看右侧的运行目标、工作目录和环境变量区域。工作目录会影响相对路径，但它不会替代环境文件绑定，两者要分别确认。

步骤三：在 Environment variables 中绑定文件

在右侧找到 Environment variables 字段。少量变量可以直接按 NAME=value 形式填写；要复用项目文件，则点击字段旁的浏览按钮，选择 .env 文件或脚本。官方文档还说明，多个文件需要用分号分隔，路径顺序应按项目的覆盖规则排列。

选择后不要只看字段里是否出现文字，还要打开变量编辑器确认键名已经被识别。若路径为空、文件位置变更，或者当前配置类型不提供该字段，先检查插件与运行目标，再决定是否退回到变量表逐项配置。

步骤四：保存、运行并做非敏感验证

点击 Apply、OK，再按运行按钮启动。验证最好让程序输出 APP_ENV 这类无敏感信息的标识；如果应用没有现成日志，可以临时增加一条开发环境日志，验证完成后删除。不要把完整的数据库密码、Token 或私钥打印出来。

如果程序仍提示变量缺失，按“当前配置—文件路径—变量名—工作目录”的顺序排查。最常见的误区是修改了一个配置，却从顶部下拉框启动了另一个配置；其次是把 .env 当成自动注入机制，实际并未在 Environment variables 字段中绑定。

常见问题

只把 .env 放在项目根目录，JetBrains IDE 会自动读取吗？

不能把自动读取当作前提。对当前运行配置，应在 Environment variables 中选择文件，或者明确填写变量。

多个环境文件应该怎样填写？

按官方字段规则用分号分隔多个文件，并在变量编辑器中确认最终键值；如果同名变量发生覆盖，要以当前项目约定的顺序为准。

为什么配置后运行仍然提示变量不存在？

优先检查启动的配置是否与刚修改的配置相同，再检查路径、变量名拼写和工作目录。确认后重新 Apply 并启动。

完成验收的标准很简单：当前 Run Configuration 指向正确的环境文件，变量编辑器能看到键值，Run 窗口能输出非敏感的开发环境标识。做到这三点，切换不同启动配置时也能快速定位问题。