能跑node命令且F5断点调试成功才算环境真正搭好；node-v报错需检查PATH配置，重装Node.js时Windows务必勾选Add to PATH、macOS/Linux需确保nvm初始化代码写入shell配置，改环境变量后必须完全重启VSCode，调试失败时应通过process.execPath比对路径并在launch.json中显式配置runtimeExecutable。
能跑 node 命令，且 VSCode 里能按 F5 断点调试，才算 Node 环境真正搭好了——其余所有操作，包括装插件、配 ESLint、写 package.json，都得排在这之后。
node -v 报错“不是内部或外部命令”怎么办
这不是 VSCode 的问题，是系统根本没找到 node。Windows 用户安装时漏勾 “Add to PATH”，macOS/Linux 用户用 nvm 但没把 source ~/.nvm/nvm.sh 写进 shell 配置，都会导致这个错误。
- 关掉所有 VSCode 窗口（macOS 在 Dock 右键选「退出」，Windows 在任务管理器确认
Code.exe已结束） - 打开系统终端（不是 VSCode 内置终端），运行
where node（Windows）或which node（macOS/Linux），确认输出路径合理（如C:Program Files odejs ode.exe或/usr/local/bin/node） - 如果没输出，重装 Node.js LTS 版，Windows 必须勾选 “Add to PATH”；macOS/Linux 用
nvm的，检查~/.zshrc是否含source ~/.nvm/nvm.sh，然后新开终端执行source ~/.zshrc - 改完环境变量后，必须重启 VSCode，否则内置终端仍读不到新 PATH
VSCode 内置终端能跑 node，但 F5 调试失败
常见报错是 Cannot find runtime 'node' 或断点不生效。根本原因不是 launch.json 写错了，而是调试器调用的 node 和你在终端里敲的不是同一个。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 先在 JS 文件里加一行：
console.log(process.execPath)，分别在终端运行node app.js和按F5调试，对比两次输出的路径是否一致 - 如果不一致，在项目根目录建
.vscode/launch.json，显式指定"runtimeExecutable"字段，例如："runtimeExecutable": "C:\Program Files\nodejs\node.exe"（Windows）或"runtimeExecutable": "/usr/local/bin/node"（macOS/Linux） - 别依赖默认生成的
"program": "${workspaceFolder}/index.js"——如果你当前打开的是server.js，就手动改成"program": "${file}"，这样 F5 总是调试当前文件
npm install 后命令在 VSCode 终端里找不到
比如装了 nodemon 或 http-server，系统终端能用，VSCode 终端却提示 command not found，大概率是 npm 全局 bin 目录没进系统 PATH。
- 运行
npm config get prefix查看全局安装路径（如D: pm-global） - 把这个路径手动加进系统环境变量
PATH（Windows）或export PATH="D: pm-globalin:$PATH"（macOS/Linux，写入~/.zshrc） - 加完后，必须完全退出并重启 VSCode，否则内置终端不会加载新 PATH
- 验证：在 VSCode 终端里直接运行
nodemon --version，有输出才算生效
最常被忽略的一点：VSCode 内置终端是否真正继承了你 shell 里的全部环境。哪怕 node -v 和 npm -v 都成功，process.execPath 和 npm config get prefix 的输出仍可能和终端不一致——调试前务必亲手验证这两项。
