WebStorm不会自动识别nvm切换的Node版本，必须手动配置Settings中Node解释器路径、Terminal shell初始化脚本及Run Configuration三处，均指向nvm对应版本的绝对路径。
WebStorm根本不会自动读nvm的当前版本
这不是bug，是设计使然：WebStorm作为GUI应用，启动时只读取系统环境变量里的PATH，而nvm切换版本（比如nvm use 18.17.0）只是临时修改当前shell的PATH，对已启动的WebStorm完全无效。你看到node -v在终端里变了，但WebStorm的Settings里还是旧路径，Run Configuration照样跑错版本。
所以别指望“自动同步”，必须手动指定绝对路径——而且得是node.exe（Windows）或node（macOS/Linux）这个可执行文件本身，不是目录。
- 查当前nvm激活路径：终端里运行
which node（macOS/Linux）或where node（Windows CMD），复制输出结果 - Windows nvm-windows用户常见路径：
C:\Users\{user}\AppData\Roaming\nvm\v18.17.0\node.exe - macOS Homebrew + nvm用户注意：
/opt/homebrew/bin/node是Homebrew装的系统版，不是nvm管理的，别混用 - 改完Settings后，重启WebStorm的Terminal窗口，否则
process.version仍可能显示旧值
WebStorm Terminal不加载nvm脚本，导致node -v始终不对
即使你在外部终端成功nvm use 16.20.2，WebStorm内置Terminal默认还是调用干净的shell，没执行nvm.sh或nvm.ps1，自然找不到nvm命令，也切不了版本。
解决办法是让Terminal启动时就加载nvm环境：
- Windows PowerShell用户：Settings → Tools → Terminal → Shell path填：
powershell.exe -ExecutionPolicy ByPass -NoExit -Command "& 'C:\Users\{user}\AppData\Roaming\nvm\nvm.ps1' - Git Bash用户：Shell path填：
bash --rcfile ~/.bashrc，并确认~/.bashrc里有export NVM_DIR="$HOME/AppData/Roaming/nvm"和[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" - macOS zsh用户：Shell path设为
/bin/zsh，确保~/.zshrc已正确加载nvm - 别改系统级
PATH来“绕过”这个问题，会污染其他项目、干扰CI流程
Run Configuration里的Node interpreter不能选“Project default”
很多人以为Settings里设了Node路径，所有npm script就自动跟着走——错了。“Project default”实际绑定的是Settings里那个全局路径，不是你nvm当前激活的版本。结果就是npm run dev跑在v14上，而你刚在终端里nvm use 18切到v18，毫无关系。
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
必须显式指定：
- 打开Run → Edit Configurations → 找到你的npm脚本（比如
dev） - 展开Node interpreter → 点击右侧
...→ Add Node Interpreter → Add Local - 路径必须精确到nvm安装的
node.exe或node二进制，例如：C:\Users\{user}\AppData\Roaming\nvm\v18.17.0\node.exe - 同一个项目换Node版本时，这里必须同步更新；不改的话，WebStorm照旧用旧版本执行，报错或兼容性问题都算“自找的”
启动WebStorm前必须先在终端激活nvm版本
这是最轻量、最可靠的同步方式——让WebStorm直接继承当前shell的环境。它绕过了所有路径配置和shell初始化的坑，尤其适合频繁切换版本的场景。
操作很简单：
- 先在支持nvm的终端（Windows Terminal / Git Bash / zsh）中执行
nvm use 20.12.2 - 再运行启动命令：
webstorm .（macOS/Linux）或webstorm.exe .（Windows） - macOS用户注意：
open -a "WebStorm" .可能不继承环境变量，优先用webstorm . - 这条路径下，Settings里的Node interpreter可以留空或填任意有效路径，因为WebStorm会直接从环境里取
node，天然匹配nvm当前版本
真正容易被忽略的是：WebStorm Terminal窗口和Run Configuration这两条线必须各自对齐，缺一不可。只配Settings，Terminal还是旧版本；只改Terminal，Run Configuration照样跑飞。三处（Settings、Terminal、Run Configuration）任一遗漏，都会导致“我以为切了，其实没切”。
