VSCode 不配置 pnpm workspace，只调用系统环境；问题根源是终端 PATH 缺失、tasks 未显式指定 pnpm、TS Server 未加载 workspace 结构，需手动对齐三者：确认全局安装并补全 PATH、用 code . 启动、tasks.json 显式写 "command": "pnpm"、打开根目录、重启 TS Server。
VSCode 本身不“配置” pnpm workspace，它只按你写的路径、命令和环境变量去调用；真正卡住的点是终端找不到 pnpm、tasks 不认 workspace 脚本、TS Server 看不见多包结构——三者全得手动对齐。
终端里 pnpm 命令报 “command not found”
这不是 VSCode 设置没开对，而是它的集成终端压根没加载 shell 初始化文件（比如 ~/.zshrc），PATH 里没有 pnpm 的安装路径。
- 先在系统终端（不是 VSCode 里）运行
which pnpm，确认已全局安装；没输出就执行npm install -g pnpm - macOS/Linux：检查
~/.zshrc是否含类似export PATH="$HOME/.local/share/pnpm:$PATH"的行 - 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 里跑的是 npm 而不是 workspace 脚本
VSCode 的任务系统完全不读 shell alias、不 fallback、不猜你装了啥；"command": "npm" 就是字面意思：去 PATH 找叫 npm 的可执行文件。
- 删掉旧版硬编码
"command": "npm"的 tasks，改用Cmd/Ctrl+Shift+P → Tasks: Configure Task → Create tasks from package.json - 该操作会读取项目根目录
package.json中的"packageManager": "pnpm@8.15.0"字段，并生成"command": "pnpm"的任务 - 若 workspace 根目录下有
pnpm-workspace.yaml，确保package.json在同一级，否则 VSCode 会误判为子包而非 workspace 根 - 想在子包里运行脚本？直接写
"args": ["run", "dev", "--filter", "my-app"]，别依赖自动推导
TypeScript 跳转失败、import 报红但代码能运行
Node.js 运行时靠 pnpm 的 resolver（已 patch 过），但 TS Server 是独立进程，它解析的是 node_modules/.pnpm 下的硬链接结构，不是扁平目录。
- 检查
node_modules/.pnpm是否存在且非空；若为空，可能是.npmrc里engine-strict=true拦截了安装 - VSCode 必须打开 workspace 根目录（即含
pnpm-workspace.yaml或根package.json的文件夹），不能只开子包文件夹 - 关闭设置项
typescript.preferences.includePackageJsonAutoImports，它会绕过符号链接逻辑，错误推导依赖 - 修改
tsconfig.json或切换包管理器后，必须手动重启 TS Server：Cmd/Ctrl+Shift+P → TypeScript: Restart TS server
调试时 pnpm exec 脚本断点失效
直接在 launch.json 里写 "program": "node_modules/.bin/jest"，很可能触发 npm 的 wrapper 脚本，而不是 pnpm workspace 下的真实二进制，导致调试器无法注入断点。
- 调试入口统一走
pnpm exec：例如"program": "${workspaceFolder}/node_modules/.pnpm/jest@29.7.0/node_modules/jest/bin/jest.js"不可靠，应改为"runtimeExecutable": "pnpm", "args": ["exec", "jest"] - 避免用
runtimeExecutable指向npm或pnpm包装脚本；调试器需要原生node实例 - ESM workspace 项目需额外加
"runtimeArgs": ["--experimental-specifier-resolution=node"]，否则import语句解析失败
最常被忽略的一点：workspace 的 pnpm-workspace.yaml 修改后，VSCode 不会自动重载 node_modules 结构；哪怕 pnpm install 成功，TS Server 仍可能缓存旧链接。必须关掉所有窗口，重新用 code . 启动，并手动重启 TS Server。
