webstorm npm脚本不可用主因是环境或配置异常：先检查json文件类型是否注册*.json模式，再确认包管理器（pnpm/yarn）是否在npm工具窗口中显式切换，monorepo需在javascript runtime中指定包管理器路径，终端报错则需校准shell path及path继承，运行脚本应建永久npm配置而非双击。
WebStorm 里 npm 脚本点不了、运行报 command not found，90% 不是 npm 没装好，而是环境或配置断在某个环节。先别重装 Node.js，按下面顺序查。
检查 package.json 是否被识别为 JSON 文件
脚本树为空、脚本名旁带红色 X、提示 “no scripts found”，大概率是 WebStorm 根本没把 package.json 当 JSON 解析。
- 打开
Settings → Editor → File Types → JSON - 确认
Registered Patterns里有*.json—— 注意不是package.json（单文件匹配无效） - 若缺失，点击
+添加*.json，然后重启 WebStorm 或重新加载项目 - 这个坑在 2024.2+ 版本升级后高频出现，和插件无关，纯 IDE 内部注册丢失
确认 WebStorm 使用的包管理器是否匹配项目实际工具
项目用 pnpm，但 WebStorm 默认走 npm，就会找不到 pnpm run dev，也不会报错，只是脚本不显示。
- 打开
npm工具窗口（右侧边栏），点右上角⚙️ → Change package manager - 选
pnpm或yarn，它会立刻重载脚本列表 - 如果项目根目录没有
pnpm-lock.yaml或yarn.lock，WebStorm 会静默回退到npm模式，不提醒也不报错 - Monorepo 场景下，还要去
Settings → Languages & Frameworks → JavaScript → Runtime，把Package manager显式指向pnpm可执行路径（如/usr/local/bin/pnpm）
验证 Node.js 和 npm 的 PATH 是否被 WebStorm 正确加载
终端里能跑 npm run dev，但 WebStorm 内置终端报 'npm' is not recognized，说明 shell 环境没继承。
- 在 WebStorm 终端执行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），对比系统终端输出 - 缺了
~/.nvm/versions/node/或%USERPROFILE%\AppData\Local\pnpm？那是 shell 配置没生效 - 进
Settings → Tools → Terminal，把Shell path改成你日常用的 shell（如/bin/zsh），并勾选Activate shell integration - 更稳的做法：别依赖终端，右键
package.json → Run 'npm run xxx'，它走的是 WebStorm 自己的Node interpreter配置，不走 shell
别双击运行脚本——建永久 NPM 运行配置
双击脚本名只是临时执行，不保存参数、不继承环境变量、调试时断点进不去，且热重载容易被强制终止。
- 右键
package.json → Run 'npm run dev'（首次会生成临时配置） - 点右上角运行配置下拉框 →
Edit Configurations…→ 找到该条目 - 确保
Scripts字段填的是dev（不是npm run dev），Working directory是项目根目录 - 勾选
Allow multiple instances，避免 HMR 重启时旧进程被杀 - 如需调试，切换到
Browsers / Live Edit标签页，填入服务地址（如http://localhost:3000）
最常被忽略的点：WebStorm 的 NPM 配置本质是调用本地 node 执行 npm-cli.js，所以它完全依赖你系统 PATH 里的 npm 版本——终端里跑不通的命令，在这里一样跑不通。别绕开终端验证直接调 IDE 配置。
