VSCode无全局默认包管理器，需分终端、任务、语言服务三场景配置：终端需确保shell初始化文件被加载以继承PATH；任务须依赖package.json的packageManager字段并重生成tasks.json；TS服务需重启服务器并验证工作区路径与模块链接结构。
VSCode 本身没有“默认包管理器”这个全局开关，所谓“配置 Yarn 或 pnpm 默认生效”，本质是分场景解决三件事：终端能认命令、任务（Task）跑对命令、语言服务（TS/JS）不报错。漏掉任一环，都会出现 yarn: command not found 或 Cannot find module。
为什么 VSCode 终端里 yarn 或 pnpm 找不到
根本不是 VSCode 配置问题，而是它的内置终端没加载你的 shell 初始化文件（比如 ~/.zshrc 或 $PROFILE），导致 PATH 里缺了 yarn/pnpm 的路径。
- 先在系统终端里运行
which yarn或which pnpm，记下输出路径（例如/opt/homebrew/bin/yarn） - 打开 VSCode 终端，再执行同样命令——如果为空，就证实了环境变量没继承
- macOS 用户：别从 Dock 启动 VSCode，改用命令行
code .，否则绕过 shell 加载 - Windows 用户：若用 Git Bash，需在 VSCode 设置中把
terminal.integrated.defaultProfile.windows设为Git Bash；PowerShell 则需先运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 通用方案：在 VSCode 设置里搜
terminal.integrated.env，手动补 PATH，例如："terminal.integrated.env.osx": {"PATH": "/opt/homebrew/bin:/usr/local/bin:${env:PATH}"}
怎么让 Tasks: Run Task 自动用 yarn 或 pnpm
VSCode 的任务系统不读 alias，也不猜你装了什么，它只按 tasks.json 里写的字面量执行。所谓“默认”，其实是靠 package.json 声明 + 自动生成实现的。
- 确保项目根目录
package.json有"packageManager": "yarn@4.0.0"或"pnpm@8.15.0"字段（Yarn 3.1+/pnpm 7+ 支持） - 删掉旧的
.vscode/tasks.json（如果存在），避免硬编码"command": "npm" - 按
Ctrl+Shift+P→ 输入Tasks: Configure Task→ 选Create tasks from package.json - 生成的任务里会是
"command": "yarn"或"command": "pnpm"，而不是npm run - 如果用了 Corepack，必须先全局执行
corepack enable，否则 tasks 可能 fallback 到系统 npm
为什么 TypeScript 还是报 “无法找到模块”
这和终端或任务无关，是 TS Server 没正确解析 pnpm/Yarn PnP 的链接结构。尤其在 monorepo 场景下，错开根目录或没构建子包类型文件，就会直接失效。
- 必须用 VSCode 打开整个 workspace 根目录（即含
pnpm-workspace.yaml或.yarnrc.yml的文件夹），不能只开packages/ui - 检查状态栏右下角是否显示
TypeScript SDK: Workspace version；如果是Project version，说明识别错了 - pnpm 用户：确认
node_modules/.pnpm存在，且每个子包package.json有有效"types"字段（如"types": "lib/index.d.ts"） - Yarn PnP 用户：确保已运行
yarn set version stable生成.pnp.cjs，且.yarnrc.yml中nodeLinker: pnp - 改完后务必执行
Ctrl+Shift+P→TypeScript: Restart TS server，否则缓存会掩盖修复效果
最易被忽略的一点：所有这些配置都依赖项目级声明（packageManager 字段）和 shell 环境的真实一致性。如果你在终端里能跑 yarn，但任务里还是走 npm，大概率是 tasks.json 没重生成，或者 package.json 少了 packageManager 字段——它不是可选项，是现代包管理器集成的契约基础。
