右下角图标显示不准但实际运行npm，根本原因是yarn/pnpm命令在webstorm内置终端中执行失败或ide未加载shell环境变量；auto-detect仅检查锁文件存在性而不验证命令可用性，须手动指定包管理器路径并点击apply生效。
右下角图标显示不准，实际运行的却是 npm
WebStorm 右下角显示 yarn 或 pnpm 图标，但点击 “Install dependencies” 却报 command not found，或者双击 dev 脚本后终端输出 npm run dev —— 这说明 IDE 并未真正切换包管理器，只是“看起来像”。根本原因只有两个：yarn --version 或 pnpm --version 在 WebStorm 内置终端（Alt+F12）里执行失败；或 IDE 没加载你的 shell 环境变量（比如 ~/.zshrc 中的 PATH 未被读取）。
Mac M 系列用户常见：用 npm install -g pnpm 安装后终端能跑，但 WebStorm 里不行——大概率是 corepack enable 没执行，或 corepack prepare pnpm@latest --activate 缺失。Windows 用户要注意：pnpm.cmd 和 yarn.cmd 必须在系统 PATH 中，不能只靠 npm 全局安装路径。
锁文件存在 ≠ 自动生效，必须验证命令可执行
WebStorm 的 “Auto-detect” 模式只检查项目根目录是否存在 yarn.lock 或 pnpm-lock.yaml，它不验证对应命令是否真能调用。结果就是：锁文件在、命令失效 → 图标显示正常，但所有操作 fallback 到 npm。
- 打开 WebStorm 内置终端（
Alt+F12），手动运行yarn --version或pnpm --version，看是否返回版本号 - 若失败，不要依赖自动识别，直接手动指定路径
-
pnpm-lock.yaml必须由pnpm install生成；如果项目原来用npm，需先删掉node_modules和package-lock.json，再运行pnpm install
手动指定包管理器路径才是唯一可靠方式
Settings → Languages & Frameworks → Node.js and npm → Package manager 下拉框里，不要选 “Auto-detect”，而应点击右侧 Select 按钮，定位到你本地的可执行文件：
- macOS Homebrew 安装：
/opt/homebrew/bin/yarn或/opt/homebrew/bin/pnpm - Windows npm 全局安装：
C:\Users\{user}\AppData\Roaming\npm\yarn.cmd或pnpm.cmd - 使用
corepack的用户：路径通常是~/.local/share/umk/corepack/pnpm（Linux/macOS）或%LOCALAPPDATA%\umk\corepack\pnpm（Windows）
改完必须点 Apply，否则新建终端、右键运行脚本仍走旧配置。这个设置只作用于当前项目，新开项目需重新配，或统一靠锁文件触发（前提是命令可用）。
npm scripts 运行时到底调谁？双重确认才保险
双击 package.json 里的脚本，实际执行的是哪个命令，取决于两个地方：
- 右下角状态栏显示的图标：显示
yarn就是yarn dev，显示pnpm就是pnpm dev，空白或npm就是npm run dev -
Run → Edit Configurations →选中该脚本 → 查看Command字段：这里会明确写出yarn run dev还是pnpm run dev
容易被忽略的是：pnpm 下 node_modules/.bin 是符号链接，某些环境变量未继承会导致脚本里调用的 vite、eslint 等命令找不到 —— 这不是包管理器配置问题，而是 PATH 未正确注入，得检查 IDE 启动方式或 Node interpreter 设置。
