根本原因是VSCode未继承系统PATH：Windows需重装Node时勾选“Add toPATH”并重启VSCode，macOS/Linux需将Node路径写入~/.zprofile或通过终端启动code .，nvm用户须调整初始化位置或硬编码PATH。
VSCode 里 node 命令报错，根本不是 VSCode 的问题，而是它没拿到正确的 PATH —— 你装了 Node.js，但系统没告诉 VSCode “node 在哪儿”。
node -v 报 “无法识别为 cmdlet” 或 “不是内部或外部命令”
这是 Windows 下 PowerShell/CMD 终端最典型的症状，本质是 VSCode 启动时没继承当前 shell 的 PATH。
- 先确认 Node.js 确实装好了：在系统 CMD 或 PowerShell 里执行
node -v和npm -v，有输出才继续 - 安装时务必勾选 “Add to PATH”（.msi 安装包默认不勾，跳过就必出问题）
- 装完必须彻底关闭所有 VSCode 窗口，再重新打开 —— 它不会热更新 PATH 缓存
- 如果用的是
fnm或nvm-windows，还要额外激活版本：fnm use 22.12.0或nvm use 22.12.0，否则 PATH 里还是空的
VSCode 终端能跑 node，但 npm install -g 的命令找不到（比如 pnpm、http-server）
说明 Node.js 运行时有了，但 npm 全局 bin 目录没进 PATH —— pnpm 这类命令根本不在 nodejs 文件夹里，而在 %APPDATA%
pm（Windows）或 ~/npm-global/bin（macOS/Linux）。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 查真实路径：
npm config get prefix，然后拼上bin（Windows 是%APPDATA% pm，macOS/Linux 一般是$(npm config get prefix)/bin） - 把这个完整路径手动加进系统环境变量 Path（不是用户变量），加完点“确定”保存
- 关掉所有 VSCode 窗口，**用系统终端执行
code .启动** —— 这样它才能继承你刚改完的 PATH - 别依赖
~/.zshrc或~/.bashrc：GUI 启动的 VSCode 不读这些文件（macOS/Linux 要改~/.zprofile）
用了 nvm/fnm，VSCode 里 node 版本不对或 npm 找不到
nvm/fnm 靠 shell 初始化脚本动态改 PATH，而 VSCode GUI 启动时根本不加载这些脚本 —— 它看到的还是系统默认的 node 或干脆没有。
- macOS/Linux：把 nvm 初始化代码（
export NVM_DIR=...; source .../nvm.sh）从~/.zshrc挪到~/.zprofile，并运行launchctl setenv PATH "$PATH" - Windows +
nvm-windows：直接在 VSCode 设置里硬编码 PATH，比如："terminal.integrated.env.windows": { "PATH": "${env:PATH};C:\Users\xxx\AppData\Roaming\nvm" } - PowerShell 用户注意执行策略：
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned（需管理员权限），否则fnm env --use-on-cd | Out-String | Invoke-Expression这类初始化会失败
调试时报 “无法启动程序”，或右下角显示 Node 解释器但 require 报错
这和终端 PATH 无关，是工作区或调试配置没对齐。
- 确保用 “文件 → 打开文件夹” 打开整个项目根目录（含
package.json或入口文件），不是只打开单个.js文件 -
launch.json里的"program"必须指向真实入口，比如"${workspaceFolder}/app.js"，不能留默认的index.js - 检查
.vscode/settings.json是否硬编码了错误的python.defaultInterpreterPath（同理也可能是node.executablePath），删掉这行最省事 - TypeScript 项目记得配
tsconfig.json，否则 JS/TS 混合时require会被误标为错误
PATH 是根因，但具体漏在哪一层（系统、shell、GUI、VSCode 设置），得一层层验证。最稳的验证方式：关 VSCode → 系统终端跑 echo %PATH%（Win）或 echo $PATH（macOS/Linux）→ 再开 VSCode 终端跑同一命令 → 对比缺哪段。漏了哪段，就补哪段，别猜。
