WebStorm自动选择yarn而非npm是因检测到项目根目录存在yarn.lock文件且系统已安装yarn；若未安装则提示“Yarn not found”，可通过Settings→Node.js and npm→Package manager手动指定yarn路径解决。
WebStorm 为什么自动选了 yarn 而不是 npm？
它不是“随便选的”——而是根据项目里有没有 yarn.lock 文件，以及你电脑上是否装了 yarn 来自动判断的。只要项目根目录存在 yarn.lock，哪怕你从没手动运行过 yarn install，WebStorm 就会默认切到 yarn 模式，并在右键 package.json 时只显示 “Run ‘yarn install’”，甚至弹窗提示“Yarn not found”（如果你真没装）。
- 检查方式：打开终端，运行
yarn --version；再看项目根目录是否存在yarn.lock - 常见误判场景：别人提交了
yarn.lock，但你团队实际用npm；或你删了yarn.lock，但 WebStorm 缓存没清，仍沿用旧判断 - 注意：
yarn.lock是“有就认”，不是“用了才生”——它本身不执行任何安装，但足以触发 IDE 的包管理器识别逻辑
怎么强制 WebStorm 用 yarn（而不是 npm 或 pnpm）？
关键不是“启用 yarn”，而是“告诉 WebStorm：这个项目，就认 yarn”。路径是统一的，但必须手动指定，不能靠勾选开关。
- 打开
Settings / Preferences → Languages & Frameworks → Node.js and npm - 在
Package manager下拉框中，**不要选 “Auto-detect”**，而是手动选yarn（或点击...选择你本地的yarn可执行文件路径，如/usr/local/bin/yarn或C:\Users\XXX\AppData\Roaming\npm\yarn.cmd） - 确保
Node interpreter指向你期望的 Node 版本——因为 WebStorm 会据此查找对应版本下全局安装的yarn - 改完不用重启，但建议关闭再重开项目，避免脚本列表缓存残留
右键运行 npm script 却调用了 yarn？
这是最典型的配置错位表现：IDE 认为你用 yarn，但你的 package.json 脚本里写的是 npm run build 风格命令，或你习惯在终端敲 npm run dev ——结果 WebStorm 自作主张转成 yarn dev 执行，而你根本没配好 yarn 环境。
- 验证方法：右键
package.json→ “Show npm Scripts”，看左侧树顶栏是否显示 “yarn scripts” 字样 - 修复动作：回到
Node.js and npm设置页，确认Package manager明确设为yarn，且路径可访问（终端里能跑yarn --version） - 如果只是临时想用 npm 运行某脚本，别改设置——直接在内置终端里敲
npm run xxx，WebStorm 的终端不会受 IDE 包管理器设置限制
装了 yarn，但 WebStorm 仍报 “Yarn not found”
报错不是因为没装，而是找不到可执行文件。尤其在 Windows 或 macOS 使用包管理器安装（如 choco、brew）后，PATH 更新可能滞后，或 WebStorm 启动时没读到最新环境变量。
- Windows 用户：检查
yarn.cmd是否在C:\Users\{user}\AppData\Roaming\npm\，并确认该路径已加入系统 PATH - macOS 用户：用
which yarn查真实路径，若输出是/opt/homebrew/bin/yarn，就在设置里手动指定它，别依赖 “Auto” - 通用避坑：不要用
npm install -g yarn安装 yarn —— 官方明确不推荐，容易与 Node 自带 npm 冲突，导致版本混乱或权限问题
真正卡住人的，往往不是“会不会配”，而是 WebStorm 读取了 lock 文件却没告诉你它读了，或者它读了 PATH 却没刷新——这些静默决策，比报错更难排查。
