VSCode不配置Node和pnpm，而是依赖系统已安装的工具，问题根源在终端PATH未加载、tasks.json未显式写pnpm、TS Server未识别workspace结构三处；必须用code .从根目录启动、改command为pnpm、打开整个workspace并重启TS Server。
VSCode 本身不“配置 Node + pnpm”，它只是调用你系统里已安装的 node 和 pnpm；真正卡住你的，通常是终端 PATH 没加载、任务写错命令、TS Server 没识别 workspace 结构这三处。
终端里 pnpm 命令找不到
这不是 VSCode 设置问题，而是它的内置终端没读取你的 shell 配置文件（比如 ~/.zshrc 或 $PROFILE），导致 PATH 里压根没有 pnpm 的 bin 路径。
- 先在系统终端（不是 VSCode 里）运行
which pnpm，确认已全局安装；没输出就执行npm install -g pnpm - macOS/Linux：检查
~/.zshrc是否包含类似export PATH="$HOME/.local/share/pnpm:$PATH"的行 - Windows PowerShell：确保
$PROFILE里有Set-Alias -Name pnpm -Value "$env:USERPROFILE\AppData\Local\pnpm\pnpm.ps1"，且已执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - VSCode 必须从命令行启动：
cd /your/monorepo/root && code .，从 Dock 或开始菜单打开会丢失 shell 环境
tasks.json 里仍跑 npm 而不是 pnpm
VSCode 的任务系统完全不认 shell alias 或 profile，"command": "npm" 就是字面意思——它去 PATH 里找叫 npm 的可执行文件，不会自动替换成 pnpm。
- 必须显式改写：
"command": "pnpm"，别依赖别名 -
"args"不用动，["run", "dev"]、["install"]这些语义 pnpm 完全兼容 - 如果项目用了
corepack，确保已执行corepack enable，且package.json中有"packageManager": "pnpm@8.15.0" - 旧版
tasks.json若硬编码了npm install，建议删掉，按Cmd/Ctrl+Shift+P → Tasks: Configure Task → Create tasks from package.json重生成
跨包跳转失败、import 报红但能运行
运行靠 Node.js 的 resolver（pnpm 已 patch 过），跳转靠 TypeScript language server。只要 TS 没加载到对应包的 index.d.ts 或源码路径，就会提示“找不到定义”。
- 必须用 VSCode 打开整个 workspace 根目录（含
pnpm-workspace.yaml和pnpm-lock.yaml的文件夹），不能只开packages/ui - 检查状态栏右下角是否显示
TypeScript SDK: Workspace version；若显示Project version或路径指向子包里的node_modules/.pnpm/，说明识别错了 - 根
tsconfig.json中需配compilerOptions.paths映射包名到源码路径，例如：{"@myorg/utils": ["packages/utils/src"]} - 子包
tsconfig.json必须设"composite": true和"references"，否则 TS 当它是独立项目 - 改完配置后务必重启 TS Server：
Cmd/Ctrl+Shift+P → TypeScript: Restart TS server
最常被忽略的是：打开方式不对，所有配置都白搭；其次是子包没启用 composite，TS 就不把它们当 workspace 成员看。这两点不解决，装再多次 pnpm 都没用。
