webstorm 不自动切换环境变量，需手动配置run configuration或用插件/脚本加载.env文件；最可靠方式是在run → edit configurations中设置environment variables，并确保working directory为项目根目录。
WebStorm 不会自动切换项目运行时的环境变量，必须手动在每个 Run Configuration 中显式配置，或通过插件/脚本加载 .env 文件 —— 否则 process.env 里永远看不到你期望的值。
Run Configuration 里填 Environment variables 最直接
这是最可控、最不容易出错的方式，尤其适合调试单个服务：
- 打开
Run → Edit Configurations…，选中你的Node.js或npm配置 - 在
Environment variables栏填入键值对，用分号分隔（Windows）或冒号（macOS/Linux），例如：NODE_ENV=development;PORT=3001 -
Working directory必须设为项目根目录（即含package.json的目录），否则后续require可能覆盖process.env - 别写
process.env.PORT || 3000这类 fallback —— 调试时应让变量明确存在，避免掩盖配置缺失问题
EnvFile 插件加载 .env 文件要满足四个硬条件
装了插件却没生效？大概率卡在这四点中的某一个：
- 插件已安装且 WebStorm 已重启（
Preferences → Plugins → EnvFile → Install → Restart IDE） -
.env文件必须放在项目根目录（不是src/或config/下） - 文件名严格为
.env；若要用.env.local，需进Preferences → Other Settings → EnvFile → Files to load手动添加 - 内容格式必须合法：
API_URL=https://api.example.com✅，API_URL="https://api.example.com"❌（引号会破坏解析）
npm script + dotenv 是跨环境最稳的代理方案
当你有多个环境文件（如 .env.test、.env.staging），又不想每个 Run Configuration 都手动配，就绕过 IDE 注入，让 Node 自己加载：
- 改
package.json的 script："dev:local": "node -r dotenv/config ./src/server.js dotenv_config_path=.env.local" - 在 WebStorm 的
npm运行配置中选这个 script，而不是直接跑node - 这样变量由 Node 进程加载，不受 IDE 环境隔离影响，也兼容
ts-node（加-r ts-node/register即可） - 注意：不要同时在
Environment variables字段和dotenv里定义同一个变量，容易覆盖或冲突
HTTP Client 和调试进程的变量是两套系统
即使 EnvFile 插件已加载 .env，你在 .http 文件里写 {{env.PORT}} 仍可能报错，因为：
- HTTP Client 的
{{env.*}}只读 EnvFile 插件加载的变量，不读process.env - 必须在
.http文件顶部声明环境块：### Environment @host = {{env.API_URL}} - 而调试时断点看到的
process.env为空，说明 Run Configuration 的Environment variables字段仍是空的 —— 插件不影响调试进程注入
真正容易被忽略的是：EnvFile 插件只管「补全提示」和「HTTP Client 变量」，它完全不参与 Node 进程启动。哪怕你看到代码里 process.env.NODE_ENV 有智能提示，只要 Run Configuration 没配，debugger 里它就是 undefined。
