根本原因是WebStorm启动的终端未加载shell配置（如~/.zshrc），导致yarn命令不可用；Mac用户需检查PATH配置并强制IDE使用zsh，Windows用户需确保yarn.cmd在系统PATH中，或直接在Settings→Node.js and npm→Package manager中手动指定yarn绝对路径。
WebStorm识别不到yarn --version怎么办
根本原因不是没装Yarn，而是WebStorm启动的终端环境没加载你的shell配置（比如~/.zshrc或~/.bash_profile），导致yarn命令不可用。Mac M系列用户、Windows用npm全局安装后未加PATH、或用corepack启用pnpm/yarn但没执行corepack enable，都容易卡在这一步。
验证方式：在WebStorm内置终端（Alt+F12）里直接运行yarn --version。如果报command not found，但系统终端能跑通，就属于环境隔离问题。
- Mac用户：检查
~/.zshrc是否包含export PATH="$HOME/.yarn/bin:$PATH"（若用Homebrew安装则可能是/opt/homebrew/bin）；然后在WebStorm中进入Help → Edit Custom Properties，添加idea.terminal.shell.path=/bin/zsh强制使用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才对）和Run → Edit Configurations里对应脚本的Command字段（应为yarn run dev而非npm run dev）。
- 改完设置后必须点
Apply，否则新建终端/右键运行仍走旧配置 - 项目打开后曾触发过自动识别（比如存在
yarn.lock），但你后来删了它，WebStorm可能仍缓存旧判断——此时需File → Reload project from disk强制刷新 - 如果团队混用包管理器（例如提交了
yarn.lock但实际用npm），建议统一删除yarn.lock并清空node_modules，再重装依赖，避免IDE与协作习惯错位
Yarn工作区（Monorepo）项目怎么让WebStorm正确索引
WebStorm不会自动把packages/下的子包当workspace成员，哪怕根目录有yarn.lock或package.json含workspaces字段。不显式声明，跨包跳转、类型提示、import路径补全全失效。
必须满足三个硬性条件：
- 用WebStorm打开的是**整个仓库根目录**（即含
package.json或yarn-workspace.yml的文件夹），而不是packages/my-app这种子路径 - 根目录
package.json中workspaces字段格式合法，例如"workspaces": ["packages/*", "apps/*"]；Yarn 3+用户注意字段名是workspaces，不是workspaces拼错或嵌套错层 - 首次打开或删过
node_modules后，必须先在终端执行yarn install生成.yarn/sdks和软链接结构，再重启WebStorm——否则TS路径映射和依赖索引都是空的
“Yarn not found”但yarn --version明明能跑
这是最典型的路径错配：WebStorm读取的Node.js interpreter和你终端里用的不是同一个环境。比如你用nvm切换了Node版本，但WebStorm设置里选的是系统自带Node（/usr/bin/node），而yarn只装在nvm管理的Node版本下。
解决方法不是重装Yarn，而是对齐Node环境：
- 在终端运行
which node和which yarn，确认两者在同一层级路径下（如都是~/.nvm/versions/node/v18.17.0/bin/node和~/.nvm/versions/node/v18.17.0/bin/yarn） - WebStorm Settings → Languages & Frameworks → Node.js and npm → Node interpreter：点击右侧
...，选择和which node输出一致的路径 - 此时
Package manager下拉框选yarn即可自动匹配同级yarn二进制，无需再手动Select
锁文件存在但命令不可达，比完全没装更难排查——因为IDE界面会显示yarn图标，实际运行却fallback到npm，这类隐性错配最容易拖慢调试节奏。
