WebStorm配置pnpm需满足两个前提：全局安装pnpm且项目根目录存在pnpm-lock.yaml；否则须手动在Settings→Languages & Frameworks→Node.js and NPM中指定pnpm可执行路径，并点击Apply生效。
如果您在 WebStorm 中希望使用 pnpm 安装、更新或运行依赖脚本，但 IDE 仍默认调用 npm 或无法识别 pnpm 命令，则可能是由于项目未满足自动识别条件或包管理器路径未正确指定。以下是解决此问题的步骤：
一、确认系统已全局安装 pnpm 并可执行
WebStorm 调用 pnpm 的前提是系统终端中能直接执行 pnpm --version 并输出版本号；若命令失败，IDE 将无法定位可执行文件，导致配置失效。
1、打开系统终端（macOS/Linux 使用 Terminal，Windows 使用 PowerShell 或 CMD）。
2、输入 pnpm --version 并回车。
3、若提示 command not found 或 'pnpm' 不是内部或外部命令，说明 pnpm 未正确安装或未加入 PATH 环境变量。
4、Mac M 系列用户建议执行：corepack enable && corepack prepare pnpm@latest --activate，避免 npm install -g pnpm 权限或 Rosetta 兼容性问题。
5、Windows 用户请检查 C:\Users\<user>\AppData\Roaming\npm\pnpm.cmd 是否存在，并确认该路径已添加至系统 PATH。
二、确保项目根目录存在 pnpm-lock.yaml
WebStorm 的自动检测机制依赖锁文件类型判断包管理器：存在 pnpm-lock.yaml 且全局 pnpm 可执行时，IDE 才会默认切换为 pnpm；缺少该文件将导致始终 fallback 到 npm。
1、在项目根目录下打开终端。
2、执行 pnpm install（首次运行会生成 pnpm-lock.yaml）。
3、确认项目根目录下已生成 pnpm-lock.yaml 文件，而非 package-lock.json 或 yarn.lock。
4、若项目已有 node_modules 且由 npm/yarn 创建，需先执行 rm -rf node_modules package-lock.json（macOS/Linux）或 rd /s /q node_modules & del package-lock.json（Windows），再运行 pnpm install。
三、手动指定 pnpm 为当前项目包管理器
当自动检测不可靠（如锁文件存在但命令不可用）时，必须通过设置界面显式绑定 pnpm 可执行文件路径，否则右键运行脚本、点击 “Install dependencies” 等操作仍将调用 npm。
1、打开 WebStorm 设置：Windows/Linux 按 Ctrl+Alt+S，macOS 按 Cmd+, 。
2、导航至 Languages & Frameworks → Node.js and npm。
3、在 Package manager 下拉框中，不要选择 Auto-detect，而是点击右侧 Select... 按钮。
4、定位 pnpm 可执行文件：
macOS Homebrew 用户选择 /opt/homebrew/bin/pnpm；
macOS MacPorts 用户选择 /opt/local/bin/pnpm；
Windows 用户选择 C:\Users\<user>\AppData\Roaming\npm\pnpm.cmd。
5、点击 OK 后，务必点击设置窗口右下角的 Apply 按钮，否则更改不生效。
四、验证配置是否生效
配置完成后，需通过双重方式确认 WebStorm 实际调用的是 pnpm：一是界面状态栏图标，二是运行脚本时的实际命令解析逻辑；任一环节不一致均会导致 node_modules 结构异常或 command not found 错误。
1、查看 WebStorm 窗口右下角状态栏，确认显示 pnpm 图标（非 npm 或空白）。
2、右键点击项目中的 package.json 文件，选择 Show npm Scripts。
3、双击任意脚本（如 dev），观察底部运行窗口中执行的命令是否为 pnpm run dev 而非 npm run dev。
4、打开 WebStorm 内置终端（Alt+F12），执行 echo $PATH（macOS/Linux）或 echo %PATH%（Windows），确认 pnpm 所在 bin 目录已被包含。
五、处理常见运行时错误
即使配置完成，某些脚本仍可能报错，主因是 pnpm 的 node_modules/.bin 路径未被注入终端 PATH，或 peerDependencies 严格校验触发缺失依赖警告；这些并非配置失败，而是 pnpm 行为特性所致。
1、若运行脚本报 command not found: vite，检查终端启动时是否加载了 shell 配置文件（如 macOS 的 ~/.zshrc），并在其中添加 export PATH=$(pnpm root -g)/.bin:$PATH。
2、若 ESLint 或 Vue 插件报 peer dep missing: vue@^3.0.0，需显式安装：pnpm add vue@latest -D，不可依赖隐式链接。
3、若右下角显示 pnpm 图标，但运行脚本仍调用 npm，请检查 Run → Edit Configurations → 选中对应脚本 → Command 字段，确认其值为 pnpm run <script> 而非 npm run <script>。
