VSCode本身无默认包管理器开关，切换pnpm需同步配置终端、tasks和TS Server三处：终端需继承shell环境PATH，tasks.json须显式写"command":"pnpm"，TS Server需重启并打开workspace根目录确保识别.pnpm结构。
VSCode 本身没有“默认包管理器”开关，所谓切换到 pnpm，本质是让终端、任务（tasks）、TypeScript 语言服务三者各自认出并正确使用 pnpm —— 漏掉任何一个环节，都会出现 pnpm: command not found、Cannot find module 或断点失效等问题。
终端里运行 pnpm 命令失败：根本不是 VSCode 设置问题
VSCode 内置终端默认不加载你的 shell 初始化文件（比如 ~/.zshrc 或 $PROFILE），所以即使你在系统终端里能直接敲 pnpm，VSCode 终端里也可能报错。
- 先在系统终端执行
which pnpm，记下路径（如/opt/homebrew/bin/pnpm）；再在 VSCode 终端里执行同样命令 —— 如果为空，就确认是环境变量没继承 - macOS 用户别从 Dock 启动 VSCode，改用命令行
code .，否则 shell 配置完全不生效 - Windows PowerShell 用户需先运行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，再往$PROFILE加Set-Alias -Name pnpm -Value pnpm - 通用兜底方案：VSCode 设置中搜
terminal.integrated.env.osx（或.linux/.windows），手动补 PATH，例如："PATH": "/opt/homebrew/bin:/usr/local/bin:${env:PATH}"
tasks.json 里仍跑 npm：别依赖 alias，必须显式写 pnpm
VSCode 的 tasks 系统不读 shell alias，也不解析 packageManager 字段 —— 它只按 JSON 字面量执行。即使你终端里 npm 已 alias 成 pnpm，任务里还是调用系统全局 npm。
- 删掉旧的
.vscode/tasks.json（如果存在），避免硬编码"command": "npm" - 按
Ctrl+Shift+P→ 输入Tasks: Configure Task→ 选Create tasks from package.json - 生成的任务会自动识别
package.json#packageManager字段（如"pnpm@8.15.0"），并设"command": "pnpm" - 如果项目用了 Corepack，务必先全局执行
corepack enable，否则 tasks 可能 fallback 到系统npm
TypeScript 报 “无法找到模块”：TS Server 没重载，或 workspace 路径不对
pnpm 的 node_modules/.pnpm 是符号链接结构，TS Server 若没重启或打开路径错误，就会沿用旧缓存路径去查 node_modules/xxx，自然找不到。
- 修改
tsconfig.json或切换包管理器后，必须手动重启 TS Server：Cmd/Ctrl+Shift+P→TypeScript: Restart TS server - 务必用 VSCode 打开整个 workspace 根目录（即含
pnpm-workspace.yaml的文件夹），不能只开子包目录（如packages/ui） - 检查状态栏右下角是否显示
TypeScript SDK: Workspace version；若显示Global version，说明没识别到 workspace - 关闭设置项
typescript.preferences.includePackageJsonAutoImports，它会绕过 pnpm 的符号链接逻辑，强行从package.json推导依赖
调试时断点不生效：别走 node_modules/.bin wrapper 脚本
很多 launch.json 配置写 "program": "node_modules/.bin/jest"，但 pnpm 下这个路径实际指向 npm 的 wrapper 脚本，而非真实二进制，导致调试环境变量丢失、断点挂不上。
- 调试脚本应直连
pnpm exec，例如："program": "${workspaceFolder}/node_modules/.pnpm/jest@29.7.0/node_modules/jest/bin/jest.js" - 更稳妥的方式是用
pnpm exec启动，把"runtimeExecutable"设为"pnpm"，"args"设为["exec", "jest", "--runInBand"] - 确保
package.json#packageManager字段存在且版本匹配，否则pnpm exec可能 fallback 到 npm
真正麻烦的从来不是配置本身，而是三处环境（终端 / tasks / TS Server）各自独立、互不通信 —— 改完一处，得挨个验证另外两处是否同步生效。尤其 monorepo 场景下，一个子包调试失败，大概率是 TS Server 还卡在旧 workspace 路径里。
