VSCode里node命令报错90%是系统PATH未生效，需先确保CMD/PowerShell中node -v和npm -v能正常输出版本号；Windows下安装Node.js时务必勾选“Add to PATH”，否则需手动将C:Program Files odejs加入系统环境变量Path并彻底重启VSCode验证。
VSCode 里 node 命令报错，90% 是系统 PATH 没生效，不是 VSCode 配错了——先确保 node -v 和 npm -v 在 CMD 或 PowerShell 里能正常输出版本号，再动 VSCode。
确认 Node.js 已正确安装并写入系统 PATH
Windows 下最常踩的坑：双击 node-v18.17.0-x64.msi 安装时跳过了 “Add to PATH” 勾选项。结果 CMD 能用，VSCode 终端却报 'node' is not recognized。
- 打开 CMD，执行
where node和where npm，应返回类似C:Program Files odejs ode.exe的路径 - 如果没输出，重装 Node.js（从
nodejs.org/download下 LTS 版），安装过程中必须勾选 “Add to PATH” - 若已安装但漏勾，手动把
C:Program Files odejs加进“系统环境变量 → Path”（注意是系统变量，不是用户变量） - 加完后彻底关闭所有 VSCode 窗口（包括后台进程），再重新打开项目文件夹
VSCode 终端仍找不到 node？检查是否继承了新 PATH
VSCode 启动时读取的是它启动那一刻的环境变量快照，不会自动感知你刚改的系统 PATH。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 在 VSCode 内置终端（
Ctrl + `）中直接运行node -v—— 这是唯一有效的验证方式 - 如果失败，别急着改
settings.json，先确认 Windows 是否真刷新了 PATH：新开一个 CMD，再跑一次node -v；失败说明系统级配置没生效 - 若 CMD 成功但 VSCode 失败，大概率是你没关干净 VSCode 托盘进程（右下角任务栏），或用了快捷方式启动（它不继承最新环境）
- 终极兜底方案：在 CMD 中进入项目目录，执行
code .启动 VSCode —— 它会继承当前终端的 PATH
调试器提示 “Cannot find runtime 'node'” 怎么办
VSCode 调试器和终端用的是两套查找逻辑。即使终端里 node -v 正常，launch.json 也可能找不到运行时。
- 按
Ctrl+Shift+P→ 输入Debug: Open Configuration→ 选Node.js，生成默认.vscode/launch.json - 检查配置中是否有
"runtimeExecutable"字段：有就删掉，让它走默认查找；没有就不用管 - 确保
"program"指向真实入口文件，比如你的主文件叫app.js，就得写成"${workspaceFolder}/app.js"，不能留默认的index.js - 如果你用
nvm-windows，调试器不自动识别当前激活版本，稳妥做法是在launch.json里显式写死路径："runtimeExecutable": "C:\Users\xxx\AppData\Roaming\nvm\v18.17.0\node.exe"
全局 npm 工具（如 nodemon）在 VSCode 终端里用不了
现象是 CMD 能运行 nodemon app.js，但 VSCode 终端提示 command not found —— 这说明 npm 全局 bin 目录没进 PATH。
- 查当前全局路径：
npm config get prefix，常见值如C:UsersxxxAppDataRoaming pm - 把这个路径手动加进系统环境变量
Path（不是 Node.js 安装目录，是 npm 的 global bin） - 加完后必须重启 VSCode（仅重启终端不够）
- 国内用户建议提前配镜像：
npm config set registry https://registry.npmmirror.com，避免后续npm install卡住
最容易被忽略的一点：VSCode 的调试器、终端、Tasks、code-runner 插件，各自读取 PATH 的时机和范围都不同。不要假设“终端能用 = 全都能用”，每个环节都要单独验证 node -v 或对应命令是否真可用。
