VSCode中pnpm命令报“无法识别”主因是终端未加载shell初始化文件导致PATH缺失pnpm路径，需先确认全局安装、补全环境变量（macOS/Linux修改~/.zshrc，Windows执行Set-ExecutionPolicy并配置$PROFILE），改用code .启动VSCode，并在tasks.json中显式指定"command": "pnpm"。
VSCode 本身不配置 Node 或 pnpm，它只调用你系统里已安装的工具；真正要解决的是终端找不到命令、任务跑错、TS 跳转失败这三类问题。
终端里 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 里写 "command": "npm" 却想跑 pnpm
VSCode 的任务系统完全不读 shell alias 或 profile，"command": "npm" 就是字面意思：去 PATH 里找叫 npm 的可执行文件，不会自动替换成 pnpm。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 必须显式改成
"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重生成
TypeScript 跳转失败、import 报红但代码能运行
运行靠 Node.js resolver（pnpm 已 patch 过），跳转靠 TS Server —— 它没加载到 node_modules/.pnpm 下的硬链接结构，就会提示“找不到定义”。
- 必须用 VSCode 打开整个 workspace 根目录（即含
pnpm-workspace.yaml和pnpm-lock.yaml的文件夹），不能只开packages/ui - 检查
node_modules/.pnpm是否存在且非空；若为空，可能是.npmrc里engine-strict=true拦截了安装 - 修改
tsconfig.json或切换包管理器后，务必重启 TS Server：Cmd/Ctrl+Shift+P → TypeScript: Restart TS server - 关闭设置项
typescript.preferences.includePackageJsonAutoImports，它会绕过 pnpm 的符号链接逻辑，错误推导依赖
调试时断点失效或环境变量丢失
常见于你在 launch.json 里直接写了 "program": "node_modules/.bin/jest" —— 这会触发 npm 的 wrapper 脚本，而不是 pnpm 安装的真实二进制。
- 调试脚本应统一走
pnpm exec入口，例如"program": "${workspaceFolder}/node_modules/.pnpm/jest@29.7.0/node_modules/jest/bin/jest.js"不可靠，容易随版本变动失效 - 更稳妥的方式是用
pnpm exec启动调试器，或在launch.json中设"runtimeExecutable": "pnpm"并配"args": ["exec", "jest"] - 注意：VSCode 的调试器不继承 shell alias，也不读
.npmrc，所有路径和命令都得显式、绝对
最易被忽略的是工作区根路径和 TS Server 状态——打开错目录、没重启服务，其他配置全对也白搭。
