WebStorm不自动切换项目环境配置文件，需手动在Run Configuration中设置环境变量（如NODE_ENV=staging）并配置Terminal shell以保持一致，否则进程启动时变量不会注入。
WebStorm 本身不提供“按项目环境自动切换配置文件”的内置机制——所谓环境配置（如 .env.development、webpack.config.prod.js、application-staging.yml）的加载逻辑，由项目自身构建/运行工具（Vite、Webpack、Spring Boot 等）控制，IDE 只负责把它们传给执行器。你真正要做的，是确保 WebStorm 的运行配置（Run Configuration）和终端环境，指向了正确的 Node 版本、环境变量、启动参数。
为什么改了 .env 文件却没生效？
常见现象：你在项目里新增了 .env.staging，在终端手动执行 NODE_ENV=staging npm run dev 能读到变量，但在 WebStorm 里点 ▶️ 运行却还是 development 行为。
- 根本原因：WebStorm 的
npm运行配置默认不注入环境变量，它只调用npm run dev，不带任何前缀 - Webpack/Vite CLI 默认只认
NODE_ENV或特定字段（如 Vite 的VITE_ENV），但 WebStorm 不会自动帮你拼接这些 - 如果你用了
dotenv加载.env.*，它也依赖启动时的process.env.NODE_ENV值来决定加载哪个文件
在 Run Configuration 里指定环境变量
这是最直接、最可控的方式，适用于 npm script、Node.js、React/Vue 启动等所有本地运行场景。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 打开
Edit Configurations...（右上角 ▶️ 旁下拉 → Edit Configurations） - 选中你的 npm 脚本（如
dev），或新建一个Node.js配置 - 在
Environment variables栏填入：NODE_ENV=staging（多个用分号隔开，Windows）或冒号（macOS/Linux） - 如果项目用自定义变量（如
API_BASE_URL），也一并加进去：NODE_ENV=staging;API_BASE_URL=https://api-staging.example.com - 勾选
Include system environment variables，避免覆盖 PATH 等基础变量
让 Terminal 自动加载对应环境的 shell 配置
当你需要在 WebStorm 内置 Terminal 中手动调试、运行 CI 命令、或验证环境变量是否就位时，终端必须和运行配置保持一致。
- Settings → Tools → Terminal → Shell path：
— Windows PowerShell 用户：设为powershell.exe -ExecutionPolicy ByPass -NoExit -Command "& 'C:\Users\XXX\AppData\Roaming\nvm\nvm.ps1'; $env:NODE_ENV='staging'"
— Git Bash 用户：确保~/.bashrc里有export NODE_ENV=staging，且 Shell path 是bash --rcfile ~/.bashrc - 不要依赖
.env文件被 Terminal 自动加载——dotenv是 Node 库，终端 shell 不认识它 - 验证方式：在 Terminal 里执行
echo $NODE_ENV，应立刻输出 staging
多项目共存时，别让环境配置互相污染
如果你用 Add Content Root 把多个项目塞进同一个 WebStorm 窗口，所有运行配置、Terminal、环境变量设置都共享一套——这时改一个项目的 NODE_ENV，另一个项目也会受影响。
- 正确做法：每个项目用独立窗口（
File → Open in New Window），再配合系统级切换（Alt+Tab/Cmd+Tab） - 每个窗口单独配 Run Configuration 和 Terminal，互不干扰
- 避免在 Settings → Languages & Frameworks → Node.js and NPM 里设全局
Node interpreter指向具体版本路径（如v18.17.0），应指向 nvm 符号链接（如C:\Program Files\nodejs\node.exe），否则换项目就得手动改解释器
真正容易被忽略的是：环境变量不是“写进文件就自动生效”，而是必须在进程启动那一刻注入。WebStorm 不会解析 .env 文件内容并转发给子进程，它只忠实地执行你写的命令和设定的变量。所以每次换环境，重点不是找配置文件放哪，而是确认 Run Configuration 和 Terminal 的启动上下文是否干净、明确、可复现。
