webstorm中node_env=development不生效的根本原因是其node.js运行配置默认不继承系统shell环境变量，需在run→edit configurations中手动设置environment variables为node_env=development；同时应显式加载dotenv、补全path、为多服务单独配置端口并验证输出。
WebStorm里NODE_ENV=development不生效
根本原因是 WebStorm 的 Node.js 运行配置默认不继承系统 shell 的环境变量，NODE_ENV 这类变量不会自动透传。即使你在终端里 export NODE_ENV=development，WebStorm 启动的进程也看不到。
- 打开
Run → Edit Configurations…，选中你的 Node.js 配置 - 在
Environment variables栏手动填入NODE_ENV=development（注意等号两边别加空格） - 如果项目还依赖其他变量（如
PORT、DB_HOST），一并写在这里，用分号分隔：NODE_ENV=development;PORT=3001;DB_HOST=localhost - 避免在代码里硬编码
process.env.NODE_ENV || 'production'—— 调试时容易误判，直接靠 WebStorm 配置驱动更可控
调试时 dotenv 文件没被加载
dotenv 是常见方案，但 WebStorm 不会自动执行 require('dotenv').config()，尤其当你用 ts-node 或 nodemon 启动时，加载时机可能错位。
- 确认
.env文件在项目根目录（即Working directory所指路径下） - 不要依赖
npm run dev脚本里的dotenv加载逻辑 —— WebStorm 的 Node.js 配置是绕过 npm script 直接调用node的 - 最稳做法：在入口文件（如
index.js或app.js）顶部显式加载：require('dotenv').config({ path: '.env' }); - 如果用 TypeScript，确保
ts-node的-r参数已启用（在Application parameters填-r ts-node/register），否则require会报错
Windows 下 PATH 中的自定义 bin 目录失效
比如你把全局 CLI 工具（如 prisma、knex）装在 C:\Users\XXX\AppData\Roaming\npm，WebStorm 启动时找不到这些命令，报 Error: spawn knex ENOENT。
- 这不是 PATH 没配好，而是 WebStorm 默认不读取 Windows 用户级 PATH（尤其非管理员安装的 Node.js）
- 进
Settings → Languages & Frameworks → Node.js and NPM，把Node interpreter改为绝对路径，例如C:\Program Files\nodejs\node.exe - 在运行配置的
Environment variables里补全 PATH：PATH=C:\Users\XXX\AppData\Roaming\npm;%PATH% - 注意顺序：把自定义 bin 目录放在
%PATH%前面，避免被系统路径里的旧版命令覆盖
多服务共用端口时环境变量冲突
微服务项目常有多个 package.json 脚本监听不同端口，但 WebStorm 默认只读取当前配置的 Environment variables，容易漏设或覆盖。
- 每个服务单独建一个运行配置（比如
auth-service、user-service），别复用同一配置 - 每个配置里明确设
PORT=3001、PORT=3002等，不要靠脚本里process.env.PORT || 3000推导 - 如果服务间需通信，用
http://localhost:3001这种硬地址，别依赖process.env.AUTH_SERVICE_URL—— 后者容易在某个配置里漏填 - 启动前检查控制台输出的 actual port，确认不是 fallback 到了默认值
console.log('NODE_ENV:', process.env.NODE_ENV) 验证，比猜强。
