VSCode 不自动配置 Node + pnpm，需确保系统已安装 pnpm 并正确配置 PATH，通过命令行执行 code . 打开项目根目录，tasks.json 中显式使用 "pnpm"，TypeScript 需识别 workspace 根目录并正确配置 tsconfig.json 路径与 composite 选项。
VSCode 本身不“配置 Node + pnpm 工作区”，它只调用你系统里已装的 node 和 pnpm，并依赖终端 PATH、工作区根路径、TypeScript 解析逻辑这三者协同才能让 import 跳转、任务执行、调试运行全部正常。问题出在哪，就修哪，别堆设置。
终端里 pnpm 命令找不到
这不是 VSCode 故意不认，而是它的内置终端没加载你的 shell 初始化文件（比如 ~/.zshrc），PATH 里压根没 pnpm 的 bin 路径。
- 先在系统终端（不是 VSCode 里）跑
which pnpm，确认已全局安装；没输出就装：npm install -g pnpm - macOS/Linux：检查
~/.zshrc是否含export PATH="$HOME/.local/share/pnpm:$PATH"（路径以pnpm root输出为准） - Windows PowerShell：先运行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，再往$PROFILE加Set-Alias -Name pnpm -Value "$env:USERPROFILE\AppData\Local\pnpm\pnpm.ps1" -
最关键一步：别从 Dock 或开始菜单开 VSCode，改用命令行进项目根目录后执行
code .—— 这样终端才能继承完整 PATH
tasks.json 里写 "command": "npm" 却想跑 pnpm
VSCode 的任务系统完全不读 shell alias 或 profile，"command": "npm" 就是字面意思去找 npm 可执行文件，不会自动替换成 pnpm。
- 必须显式改成
"command": "pnpm"，"args"不用动，比如["run", "dev"]依然有效 - 如果项目用了
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 报红、Go to Definition 跳不到，但代码能跑
运行靠 Node.js resolver（pnpm 已 patch），跳转靠 TypeScript language server —— 两者走的不是一套路径。TS 没加载到源码或类型定义，就会报红或跳失败。
- 必须用 VSCode 打开含
pnpm-workspace.yaml和pnpm-lock.yaml的**根目录**，不能只开packages/ui这类子包 - 检查状态栏右下角是否显示
TypeScript SDK: Workspace version；若显示Project version或指向子包node_modules/.pnpm/，说明识别错了 - 根
tsconfig.json需配compilerOptions.paths，例如：{"my-utils": ["packages/my-utils/src"]}，且子包tsconfig.json中baseUrl要与之匹配（如"./src"） - 子包
package.json必须声明"types": "./dist/index.d.ts"（如果你真生成了 d.ts），否则删掉这行，避免 TS 优先找构建产物而忽略源码 - 删掉
node_modules和.vscode缓存，重启 TS Server：Ctrl+Shift+P→TypeScript: Restart TS server
调试时 launch.json 启动失败或断点不生效
调试器不走 npm script，也不走 pnpm wrapper，它直接调 node。如果 pnpm exec 被用于启动服务，调试器却没配对，就会绕过源码映射。
-
launch.json的program字段应指向编译后入口（如"${workspaceFolder}/dist/index.js"），而非src下的 ts 文件 - 确保
sourceMaps开启，且构建工具（如 tsc、esbuild）生成了正确 sourcemap - 推荐用
pnpm exec启动调试：把"program"改成"${workspaceFolder}/node_modules/.bin/pnpm"，"args"设为["exec", "node", "--inspect-brk", "${workspaceFolder}/dist/index.js"] - 不要在
launch.json里硬写死runtimeExecutable路径——除非你明确要切 Node 版本；统一用 nvm +code .启动更可靠
最常被忽略的是打开方式：开错根目录，所有配置都白搭；其次是子包 tsconfig.json 没设 "composite": true，导致 TS Server 不把它当 workspace 成员处理。这两处一错，其他配置全失效。
