【WebStorm】运行报错：env: node: No such file or directory
WebStorm 运行 npm scripts 报错 env: node: No such file or directory 的解决方案
问题描述
在 WebStorm 中点击 package.json 的dev脚本运行时，报错：
env: node: No such file or directory但在终端中直接执行npm run dev却完全正常。
原因分析
1. 根本原因：macOS GUI 应用不继承 shell 的 PATH
macOS 的 GUI 应用（如 WebStorm）通过 Finder 或 Launchpad 启动时，不会加载~/.zshrc中的环境变量配置，因此无法获取 nvm 初始化后注入的 node 路径。
而在终端中，shell 启动时会自动 source.zshrc，nvm 初始化逻辑正常执行，所以node可以被找到。
2. 报错的直接触发点
npm 安装的脚本文件（如node_modules/.bin/vite）的 shebang 行为：
#!/usr/bin/env node当 WebStorm 执行该脚本时，/usr/bin/env会在当前 PATH 中查找node，但此时 PATH 中不包含 nvm 的 node 路径，因此报错。
3. 验证方式
在终端中确认 node 是通过 nvm 安装的：
$whichnode/Users/kw/.nvm/versions/node/v22.21.1/bin/node查看脚本的 shebang：
$head-1node_modules/.bin/vite#!/usr/bin/env node解决方案
方案一：在运行配置中设置 PATH 环境变量（推荐）
- 点击 WebStorm 顶部工具栏的运行配置下拉框 →Edit Configurations…
- 选中对应的 npm 运行配置
- 在Environment variables中添加：
PATH=/Users/kw/.nvm/versions/node/v22.21.1/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin注意：请将路径替换为你实际的 nvm node 版本路径，可通过
which node获取。
- 点击 OK，重新运行即可。
方案二：使用 WebStorm 内置终端
在 WebStorm 底部打开Terminal标签页，nvm 会被正确加载，直接输入：
npmrun dev即可正常运行。这是因为 WebStorm 的内置终端会加载 shell 配置文件。
总结
| 方案 | 适用场景 | 影响范围 |
|---|---|---|
| 运行配置设置 PATH | 单个项目、安全可控 | 仅当前运行配置 |
| 使用内置终端 | 快速验证、临时使用 | 仅终端会话 |
| 全局设置 launchctl PATH | 一劳永逸 | 全局所有 GUI 应用 |
推荐方案一，只影响当前项目的运行配置，最安全可控。切换 node 版本时只需更新对应路径即可。
ps: 问题通过Qoder插件分析解决，博客文档也由 AI 总结完成。