vscode终端找不到pnpm是因为其内置终端未加载shell初始化文件导致path缺失corepack shim路径，需在shell配置中添加shim路径并重启vscode，且tasks.json中须显式写"pnpm"而非依赖alias，同时确保package.json的packagemanager字段正确且位于项目根目录。
VSCode终端里pnpm命令找不到，但package.json写了packageManager
这是最常被误以为是VSCode“没配置好”的问题。实际原因很直接：VSCode内置终端没加载你的shell初始化文件（比如~/.zshrc），所以PATH里压根没有Corepack生成的shim路径。
验证方式：在系统终端（不是VSCode里）运行which pnpm，如果没输出，说明Corepack的shim根本没进PATH；如果有输出，比如/Users/xxx/.nvm/versions/node/v22.21.0/lib/node_modules/corepack/shims/pnpm，那问题就出在VSCode终端没继承这个PATH。
- macOS/Linux：确认
~/.zshrc末尾有export PATH="$HOME/.nvm/versions/node/v22.21.0/lib/node_modules/corepack/shims:$PATH"（路径以which corepack为准） - Windows PowerShell：在
$PROFILE里加Set-Alias -Name pnpm -Value "$env:LOCALAPPDATA/corepack/shims/pnpm.ps1"，并确保已执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 关键动作：改完后必须重启VSCode（不是仅关闭终端），否则
code .启动时仍用旧环境
tasks.json里写"npm install"却想跑pnpm，结果报command not found
VSCode的任务系统不认alias、不读profile、不走shell解析——它就是字面匹配PATH里的可执行文件名。你写"command": "npm"，它就去找npm，哪怕你在终端里alias了npm=pnpm也完全无效。
正确做法只有一条：显式替换。
- 把
"command": "npm"改成"command": "pnpm"或"command": "corepack" - 如果用
corepack，args得写成["pnpm", "install"]，不能只写["install"] - 确保项目根目录下
package.json里packageManager字段存在且格式正确，例如"pnpm@9.15.0"（不能是"pnpm@^9"或"pnpm@latest"） - CI/CD中同理：不要依赖
npm install自动fallback，显式写corepack pnpm install
TS Server跳转失败、import报红但运行正常
这不是Corepack的问题，而是TypeScript语言服务没识别到pnpm的链接结构。Node.js运行时能resolve是因为pnpm patch了resolver，但TS Server只看node_modules和tsconfig.json里的paths，不会主动扫描.pnpm硬链接目录。
必须满足三个条件：
- VSCode工作区打开的是整个monorepo根目录（含
pnpm-workspace.yaml和pnpm-lock.yaml），不能只开某个packages/foo子目录 -
tsconfig.json里启用"composite": true，并在"references"中声明workspace内其他包 - 重启TS Server：按
Ctrl+Shift+P→ 输入Typescript: Restart TS server，别指望保存tsconfig就自动生效
切换Node版本后pnpm版本错乱或corepack失效
nvm或n切换Node后，Corepack的shim路径可能失效——因为新Node版本下的corepack二进制位置变了，旧shim指向的路径已不存在。
这不是bug，是设计使然。每次切换Node主版本（如v18 → v22），都必须重新启用Corepack：
- 运行
corepack enable（不是corepackenable，注意空格） - 进入项目目录后，手动触发一次
corepack use pnpm@9.15.0，强制重写shim - 检查
pnpm --version是否输出预期版本；如果仍是旧版，说明packageManager字段被忽略，大概率是package.json语法错误或JSON校验失败
最容易被忽略的是：Corepack只读取项目根目录的package.json，如果你在子目录里打开VSCode，它根本看不到那个packageManager字段。
