VSCode不配置pnpm而依赖系统环境，问题根源在终端PATH、工作区根路径和TS Server解析逻辑三处；需确保pnpm全局安装且PATH正确、用code .从根目录启动、tasks.json显式写pnpm、TS配置启用composite和paths映射。
VSCode 本身不“配置 pnpm”，它只是调用你系统里已安装的 pnpm，并依赖 TypeScript 语言服务、终端环境和项目结构来正确解析依赖与跳转。真正要解决的问题是：为什么 import 报红但能运行？为什么 Go to Definition 跳不到其他包？为什么任务里 pnpm 命令找不到？答案不在 VSCode 设置里，而在三处关键链路上：终端 PATH、工作区根路径、TS Server 的模块解析逻辑。
终端里 pnpm 命令找不到
这不是 VSCode 的 bug，而是它的内置终端没加载你的 shell 初始化文件（比如 ~/.zshrc），导致 PATH 里没有 pnpm 的安装路径。
- 先在系统终端（不是 VSCode 里）运行
which pnpm，确认它确实装好了；如果没输出，先全局安装：npm install -g pnpm - macOS/Linux 用户：检查
~/.zshrc是否包含export PATH="$HOME/.local/share/pnpm:$PATH"（或你实际的 pnpm bin 路径） - Windows PowerShell 用户：运行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，再在$PROFILE里加Set-Alias -Name pnpm -Value "$env:USERPROFILE\AppData\Local\pnpm\pnpm.ps1" - VSCode 启动方式很重要：从 Dock 或开始菜单打开，常拿不到 shell 环境；改用命令行执行
code .才能继承完整PATH
tasks.json 里跑的是 npm 而不是 pnpm
VSCode 的任务系统完全不读取 shell alias 或 profile，"command": "npm" 就是字面意思——它会去 PATH 里找名为 npm 的可执行文件，不会自动替换成 pnpm。
- 必须显式写死：
"command": "pnpm"，不能依赖别名 - 所有
"args"保持不变，pnpm完全兼容npmscript 语义，比如["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 报红但代码能运行
运行靠 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，说明识别错了 - 根
tsconfig.json中启用references，每个子包tsconfig.json必须设"composite": true - 在根
tsconfig.json的compilerOptions.paths中添加映射，例如：{"my-utils": ["packages/my-utils/src"]}；同时子包tsconfig.json的baseUrl要匹配该路径（如"./src"） - 删掉
node_modules和.vscode缓存，按Ctrl+Shift+P→TypeScript: Restart TS server
pnpm 安装后镜像源和权限问题
国内用户不配镜像源，pnpm add 会极慢甚至超时；PowerShell 默认策略还会直接拦截脚本执行。
- 安装完后立刻配置国内源：
pnpm config set registry https://registry.npmmirror.com/ - Windows 用户首次使用前，务必在 PowerShell 中运行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 不要在项目里混用
npm install和pnpm install，否则node_modules/.pnpm结构会被破坏，TS Server 将无法解析硬链接 - 如果
pnpm install后node_modules/.pnpm为空，检查项目根目录是否有.npmrc，里面是否写了engine-strict=true—— 这个配置会拦截安装
最常被忽略的一点是：VSCode 不会自动感知 pnpm-workspace.yaml，它只认你打开的文件夹。哪怕配置全对，只要不是从根目录启动，所有跨包能力就形同虚设。重启 TS Server 是补救手段，但治标不治本；真正的起点永远是——关掉当前窗口，回到根目录，再敲 code .。
