webstorm报“yarn not found”根本原因是其内置终端未加载shell配置（如~/.zshrc），导致path中yarn路径不可见；mac用户需配置path并强制ide使用zsh，windows用户需确保yarn.cmd在系统path中，或直接在settings→node.js and npm→package manager中手动指定yarn绝对路径。
WebStorm报“Yarn not found”但终端能跑yarn --version
根本不是Yarn没装，而是WebStorm启动的终端没加载你的shell配置（比如~/.zshrc），导致它找不到yarn命令。Mac用户尤其常见——系统终端里yarn --version返回正常，但WebStorm内置终端（Alt+F12）一敲就报command not found。
解决方法分三类：
- Mac用户：确认
~/.zshrc里有export PATH="$HOME/.yarn/bin:$PATH"（Homebrew安装则可能是/opt/homebrew/bin）；然后在Help → Edit Custom Properties里加一行：idea.terminal.shell.path=/bin/zsh - Windows用户：查
yarn.cmd真实路径（通常是C:\Users\{user}\AppData\Roaming\npm\yarn.cmd），确保该目录已加入系统PATH，不能只靠Node.js自带的npm bin路径 - 通用兜底法：直接在
Settings → Languages & Frameworks → Node.js and npm → Package manager里点Select按钮，手动选中yarn可执行文件，不依赖环境变量
改了Package manager设置却还是调用npm run
WebStorm的包管理器设置只影响右键菜单、脚本树和运行配置生成逻辑，不接管你在终端里敲的命令。但如果你发现右键package.json→“Run ‘dev’”仍执行npm run dev，说明配置没生效或被缓存覆盖。
验证是否真正生效，看两个地方：
- 右下角状态栏图标：显示
yarn才对，空白或npm就是没切过去 -
Run → Edit Configurations里对应脚本的Command字段：必须是yarn run dev，而不是npm run dev - 改完设置后必须点
Apply，否则新建终端/右键运行仍走旧配置 - 项目曾触发过自动识别（比如存在
yarn.lock），但你后来删了它，WebStorm可能仍缓存旧判断——此时需File → Reload project from disk强制刷新
Monorepo里yarn install失败或子包脚本报command not found
WebStorm默认用系统全局npm，但Monorepo项目大概率用的是pnpm或yarn。右下角没显示yarn图标，就说明它正在用错包管理器——哪怕你本地装了yarn，IDE也可能完全无视。
关键动作：
- 进
Settings → Languages & Frameworks → JavaScript → Runtime，确认Package manager路径指向yarn可执行文件，不是npm - 删过
node_modules后，必须先运行yarn install（右键根目录package.json→Run 'yarn install'），再重启WebStorm；否则.yarn软链接不全，脚本找不到依赖 - 子包里的
yarn run dev报command not found？别点编辑器里自动识别的脚本行——那是按主项目根目录执行的。必须新建npm配置，显式指定Package.json path为子包路径，Working directory也设成该子包目录
手动指定yarn路径后仍报internal/modules/cjs/loader.js:892
这个错误本质是Node.js模块加载失败，通常发生在yarn install中途崩溃或node_modules结构损坏之后。它和路径配置无关，而是依赖状态异常。
典型表现：
- 项目根目录有
yarn.lock，但node_modules里缺vue-cli-service这类二进制入口文件 - 报错堆栈里出现
Cannot find module '../package.json'或MODULE_NOT_FOUND - 重装依赖时卡在某个包，或提示
ENOENT: no such file or directory
修复步骤很直接：
- 删掉整个
node_modules和yarn.lock - 确保当前Terminal已切换到项目根目录（不是父级或子包目录）
- 运行
yarn install，不要加--frozen-lockfile或--offline - 如果公司内网，提前配好代理：
yarn config set https-proxy http://proxy.company.com:8080
最常被忽略的一点：WebStorm的“自动重载项目”功能有时会抢在yarn install完成前扫描node_modules，导致它误判依赖缺失。等命令彻底结束、光标回到新行后再去点Reload project from disk。
