WebStorm 找不到 package.json 脚本，首要检查 JSON 文件类型是否注册：Settings → Editor → File Types → JSON → 添加 *.json 模式；其次需手动刷新 npm 工具窗口或切换 package.json 节点；运行脚本应创建永久 NPM 配置而非双击；pnpm/yarn 需在 npm 工具窗口⚙️中显式切换包管理器。
WebStorm 找不到 package.json 里的脚本？先检查 JSON 文件识别是否失效
这是更新 WebStorm 后最常遇到的问题：npm 工具窗口里脚本树为空，或脚本名旁带红色 X，提示“no scripts found”。根本原因不是 Node.js 没装好，而是 WebStorm 没把 package.json 当作 JSON 文件解析。
- 打开 Settings / Preferences → Editor → File Types
- 在右侧列表中找到
JSON类型，检查其 “Registered Patterns” 是否包含*.json - 如果缺失，点击
+号添加*.json—— 注意不是package.json（单文件匹配不生效） - 改完后重启 WebStorm 或重新打开项目，
npm工具窗口会立刻重建脚本树
这个坑在 2024 年底起的多个 WebStorm 小版本更新中反复出现，尤其从 2023.x 升级到 2024.2+ 后更常见。它和插件无关，纯属 IDE 内部文件类型注册丢失。
怎么让 WebStorm 正确运行 npm run dev 这类脚本？别只靠双击
双击脚本名看似方便，但实际执行的是“临时配置”，不保存参数、不继承环境变量、调试时也进不了断点。真要稳定运行或调试，必须建一个永久的 NPM 运行/调试配置。
- 右键
package.json→ Run 'npm run dev'（首次会生成临时配置） - 点击右上角运行配置下拉框 → Edit Configurations… → 找到刚生成的条目
- 勾选 Allow multiple instances（避免热重载时被强制终止）
- 在 Scripts 字段明确填入
dev，不要留空或写全命令npm run dev - 如需调试，切换到 Browsers / Live Edit 标签页，填入服务地址（如
http://localhost:3000）
WebStorm 的 NPM 配置本质是调用本地 node 执行 npm-cli.js，所以它依赖你系统 PATH 里的 npm 版本，而不是内置 Node.js 解释器。换言之：你终端里能跑的，这里就能跑；终端里报错的，这里一样报错。
pnpm 或 yarn 脚本不显示？WebStorm 默认只认 npm
WebStorm 的 npm 工具窗口默认只扫描 scripts 字段，但它本身支持 pnpm 和 yarn —— 前提是你没把它当成“npm 替代品”来用，而是显式告诉它：“这次我要用 pnpm”。
- 打开
npm工具窗口 → 点击右上角⚙️→ Change package manager - 选择
pnpm或yarn，它会自动重载当前package.json下的脚本 - 若项目根目录没有
pnpm-lock.yaml或yarn.lock，WebStorm 会静默回退到npm模式，不会报错也不会提醒 - 多
package.json场景下（如 monorepo），每个节点可独立设置包管理器，无需全局切换
注意：pnpm 的 exec、run 子命令行为和 npm run 不完全一致（比如环境变量注入时机），WebStorm 不做适配，它只是把你的选择透传给终端。所以如果你的 pnpm run build 在终端正常，在 WebStorm 里失败，大概率是路径或 shell 初始化差异导致的。
为什么改了 scripts 但 WebStorm 不刷新？缓存比你想的顽固
WebStorm 不是实时监听 package.json 变更的。它只在以下时机重建脚本树：首次打开项目、手动点击工具栏的 ⟳ 刷新按钮、切换到另一个 package.json 节点、或重启 IDE。
- 编辑完
scripts后，别等它自动更新 —— 直接点 npm 工具窗口右上角的⟳ - 如果点了没反应，试试右键当前脚本节点 → Reload package.json
- 极端情况（比如刚加了 workspace 协议或自定义 resolver），可能需要清空 WebStorm 缓存：File → Invalidate Caches and Restart → Invalidate and Restart
最易被忽略的一点：WebStorm 的脚本树只读取当前选中的 package.json。你在子目录改了 scripts，但 npm 工具窗口顶部显示的是根目录的路径，那新增脚本永远不会出现 —— 必须先点击 ? 图标，手动切换到那个子目录下的 package.json 节点。
