webstorm 不自动智能切换 yarn/pnpm，仅依据锁文件和全局命令可用性判断，配置逻辑不同易导致脚本错配或 command not found 错误；识别失败主因是终端中 yarn --version/pnpm --version 执行失败或未读取正确 node.js 全局 bin 路径。
WebStorm 不会自动在 yarn 和 pnpm 之间“智能切换”——它只看锁文件 + 全局命令是否可用，且两者配置逻辑不同，混用时极易错配脚本行为或报 command not found 错误。
为什么 WebStorm 有时识别不了 yarn 或 pnpm
核心原因就两个：yarn --version 或 pnpm --version 在终端里执行失败，或者 WebStorm 没读到你期望的 Node.js 环境下的全局 bin 路径。
- Mac M 系列用户常见：用
npm install -g yarn安装后，yarn --version在终端能跑，但在 WebStorm 内置终端（Alt+F12）里报 command not found —— 很可能是 shell 配置（如~/.zshrc）没被 IDE 启动的 shell 加载 - Windows 用户注意：
pnpm.cmd和yarn.cmd必须在 PATH 中，不能只靠 npm 全局安装路径；如果用corepack启用 pnpm，得确认corepack enable已执行且生效 - WebStorm 的 “Auto-detect” 模式不可靠：它只检查项目根目录是否存在
yarn.lock或pnpm-lock.yaml，但不会验证对应命令是否真能执行。锁文件存在 + 命令失效 = 右下角显示图标，实际运行仍 fallback 到 npm
手动指定包管理器路径最稳妥
Settings → Languages & Frameworks → Node.js and npm → Package manager 下拉框里，不要选 Auto-detect，直接点右侧 Select 按钮定位可执行文件。
- yarn 路径示例：
/opt/homebrew/bin/yarn（macOS Homebrew）、C:\Users\{user}\AppData\Roaming\npm\yarn.cmd（Windows npm 全局安装） - pnpm 路径示例：
/opt/homebrew/bin/pnpm（macOS）、C:\Users\{user}\AppData\Roaming\npm\pnpm.cmd（Windows） - 改完必须点
Apply，否则新建终端、右键运行脚本仍走旧配置 - 这个设置作用于当前项目，不是全局；新开项目需重新配，或统一用锁文件触发自动识别（前提是命令可用）
npm scripts 运行时到底调谁？看右下角图标和配置页双重确认
双击 package.json 里的 dev 脚本，实际执行的是哪个命令，取决于两个地方：
- 右下角状态栏显示的图标：显示
yarn就是yarn dev，显示pnpm就是pnpm dev，空白或npm就是npm run dev - Run → Edit Configurations → 选中该脚本 → 查看
Command字段：这里会明确写出yarn run dev还是pnpm run dev - 常见坑：脚本里写了
vite build，但node_modules/.bin/vite是 pnpm 创建的软链，而 WebStorm 实际调了npm run build→ 找不到 vite 命令，报command not found: vite - 临时救急：不想改设置？直接在内置终端里敲
yarn dev或pnpm dev，终端不受 IDE 包管理器设置限制
monorepo 项目里 yarn workspaces 和 pnpm workspace 混用要格外小心
WebStorm 对 yarn workspaces 有专门索引逻辑，会把各子包依赖合并到根 node_modules；但对 pnpm workspace，它只当普通 pnpm 项目处理，不会自动跨 workspace 解析依赖。
- 如果你用
yarn workspaces，但 WebStorm 设置成了 pnpm，右键运行子包脚本大概率失败：因为 pnpm 不认yarn workspaces的字段，也不会创建对应链接 - 反之，用
pnpm workspace却设成 yarn，yarn install会清掉node_modules并按 yarn 规则重建，破坏 pnpm 的硬链接结构，后续pnpm run可能找不到二进制 - 验证方式：打开
package.json→ 右键 → Show npm Scripts，顶部标题栏写的是yarn scripts还是pnpm scripts，比图标更准
