VSCode中pnpm替代npm需分场景配置：终端通过shell别名实现，tasks.json须显式写pnpm，TS服务需重启并检查.pnpm结构，调试应直连pnpm exec避免wrapper干扰。
VSCode终端默认用pnpm而不是npm
VSCode新开终端时默认调用的是系统 shell，不会自动切换包管理器——所谓“集成”其实是让终端启动时执行 pnpm 而非 npm，本质是改 shell 的初始化行为或 VSCode 的终端配置。
直接改 terminal.integrated.defaultProfile.* 不起作用，因为那只是选 shell（如 PowerShell、zsh），不是换命令。真正有效的是在 shell 启动脚本里 alias 或修改 PATH 优先级：
- macOS/Linux：在
~/.zshrc或~/.bashrc末尾加alias npm=pnpm，然后重启终端或运行source ~/.zshrc - Windows（PowerShell）：在
$PROFILE中添加Set-Alias -Name npm -Value pnpm，注意需先执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser才能加载 profile - 不推荐改
terminal.integrated.env.*注入 PATH，容易和项目本地.nvmrc或corepack冲突
tasks.json里pnpm脚本执行失败：command not found
VSCode 任务（tasks.json）默认不读取 shell 的 alias 或 profile，所以即使你在终端里 npm 能当 pnpm 用，任务里仍会报 npm: command not found 或实际跑的是旧版 npm。
解决方式只有一条：显式写死 pnpm，别依赖别名：
- 把
"command": "npm"改成"command": "pnpm" - 所有
"args"里原本的"run"、"dev"等保持不变，pnpm 完全兼容 npm script 语义 - 如果项目用了
corepack，确保corepack enable已执行，且package.json#packageManager字段正确（如"pnpm@8.15.0"），否则 tasks 可能 fallback 到系统全局 npm
{
"version": "2.0.0",
"tasks": [
{
"label": "dev",
"type": "shell",
"command": "pnpm",
"args": ["run", "dev"],
"group": "build",
"isBackground": true
}
]
}
IntelliSense 和类型提示没识别pnpm安装的包
VSCode 的 JavaScript/TypeScript 语言服务（TS Server）本身不关心你用什么包管理器，它只看 node_modules 结构和 tsconfig.json 配置。pnpm 的硬链接结构可能导致 TS Server 漏掉某些依赖路径。
常见症状：跳转定义失败、import 提示“无法找到模块”，但代码实际能运行。
- 检查
node_modules/.pnpm是否存在，不存在说明 pnpm 没真正安装成功（比如被 .npmrc 里的engine-strict=true拦截） - 在 VSCode 设置中关闭
typescript.preferences.includePackageJsonAutoImports，避免它错误地从package.json#dependencies推导而忽略 pnpm 的符号链接 - 重启 TS Server：快捷键
Ctrl+Shift+P→ 输入Restart TS server，不要只 reload window - 如果用 TypeScript 5.0+，确认
tsconfig.json里没配"moduleResolution": "node16"且项目含exports字段——pnpm 对 exports 的解析比 npm 更严格，可能需要加"moduleResolution": "bundler"
调试时npm script断点不触发
VSCode 的调试器（.vscode/launch.json）启动 npm script 时，若底层仍是 npm，就不会走 pnpm 的 bin 包逻辑，导致 sourcemap 路径错乱或 node 进程没加载正确的入口文件。
根本解法：绕过 script 抽象层，直连 pnpm 的执行入口：
- 不要用
"runtimeExecutable": "npm"，改用"runtimeExecutable": "pnpm" -
"args"改为["exec", "node", "--inspect-brk", "${workspaceFolder}/src/index.ts"]，这样跳过 npm run 的 wrapper，避免多一层进程封装 - 如果必须调试
pnpm run dev这类命令，确保对应 script 在package.json中已加--inspect-brk（如"dev": "node --inspect-brk -r ts-node/register src/index.ts"），否则断点不会生效
pnpm 的并发安装和符号链接机制对编辑器来说是透明的，但它的执行路径和 npm 不同——这点在调试和类型推导里最容易暴露，不能靠“看起来一样”就假设行为一致。
