pnpm命令未找到的根本原因是path未包含其安装路径，需先在系统终端运行which pnpm确认安装，再根据平台将对应bin目录加入shell配置文件并source，或启用corepack。

终端里输入 pnpm 报 command not found

这不是 VSCode 设置问题，而是它内置终端没加载你的 shell 初始化文件（比如 ~/.zshrc 或 $PROFILE），PATH 里压根没有 pnpm 的安装路径。

先在系统终端（不是 VSCode 里）运行 which pnpm，确认已全局安装；如果没输出，执行：npm install -g pnpm。

• macOS/Linux：检查 ~/.zshrc 是否包含类似 export PATH="$HOME/.local/share/pnpm:$PATH" 的行（路径以 which pnpm 输出为准）
• 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 里写 "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 保持不变，pnpm 完全兼容 npm script 语义。

• 旧版 tasks.json 若硬编码了 npm install，建议删掉后按 Cmd/Ctrl+Shift+P → Tasks: Configure Task → Create tasks from package.json 重生成
• 若项目用了 corepack，确保已执行 corepack enable，且 package.json 中 packageManager 字段声明了版本，例如 "pnpm@8.15.0"

TypeScript 跳转失败、import 报红但代码能运行

Node.js 运行时靠 pnpm patch 过的 resolver，能正常加载；但 VSCode 的 TypeScript Server 只看 node_modules/.pnpm 下的硬链接结构，容易漏掉路径。

• 必须用 VSCode 打开整个 workspace 根目录（即含 pnpm-workspace.yaml 和 pnpm-lock.yaml 的文件夹），不能只开 packages/ui 子目录
• 检查状态栏右下角是否显示 TypeScript SDK: Workspace version；如果不是，说明 TS Server 没加载项目级配置
• 修改 tsconfig.json 或切换包管理器后，务必手动执行 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" 不可靠，别硬编码路径
• 推荐写法："runtimeExecutable": "pnpm", "args": ["exec", "jest"]，让 pnpm exec 做环境隔离和二进制定位
• 如果项目有 pnpm exec 不识别的 CLI（比如某些老工具），需确认其是否支持 --no-registry 或 --ignore-scripts 等参数，避免被 wrapper 干预

真正卡住人的从来不是“怎么配”，而是终端 PATH、tasks 显式调用、TS Server 重启这三处链路没对齐。任何一个环节掉链子，都会表现为“看起来配好了，但就是不 work”。