vscode和node.js必须分别独立安装并配置，vscode不自带node.js运行时；需在系统终端验证node -v和npm -v成功，确保path生效，并使vscode终端继承shell环境，launch.json中program推荐设为"${file}"。
VSCode 和 Node.js 是两个独立软件，必须分别安装、各自配置，不能互相替代或自动联动。很多人卡在“装完 VSCode 就能跑 Node”，结果 node -v 在 VSCode 终端里报错，本质是 Node.js 根本没装好，或环境变量没生效。
Node.js 必须独立安装并验证可用性
VSCode 不自带 Node.js 运行时，它只是个编辑器。你得先从 nodejs.org 下载安装包，而不是靠 VSCode 插件“补上”。
- Windows 用户：安装时务必勾选 Add Node.js to PATH；否则手动把
C:\Program Files\nodejs（或你自定义的安装路径）加进系统Path变量 - macOS/Linux 用户：若用
homebrew安装，确认which node输出路径已写入~/.zshrc或~/.bash_profile - 验证方式只有一种：关掉所有终端和 VSCode，新开一个系统终端（不是 VSCode 里的 Terminal），执行
node -v和npm -v都能输出版本号才算成功
VSCode 终端是否继承 shell 环境，决定 npm 能不能用
即使你在系统终端里能用 nodemon，但在 VSCode 里提示 command not found，大概率是 VSCode 的终端没读取你的 shell 配置文件（比如 ~/.zshrc）。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 重启 VSCode 是最直接的办法——它会在启动时重新加载 shell 环境
- 临时补救：在 VSCode 终端里手动执行
source ~/.zshrc（macOS/Linux）或refreshenv（PowerShell） - 别依赖“VSCode 自动识别 npm 镜像或全局路径”，
npm config get prefix和npm config get registry的输出，必须和你在系统终端里看到的一致
launch.json 中的 program 字段别写死路径
VSCode 调试时生成的默认 launch.json 通常是 "program": "${workspaceFolder}/app.js"，但你项目入口可能是 index.js、server.js 或其他名字。
- 推荐写成
"program": "${file}"：调试当前打开的 JS 文件，不用反复改配置 - 如果固定用某个入口，明确写成
"program": "${workspaceFolder}/index.js"，别用相对路径如./index.js，VSCode 解析可能出错 - 注意：
launch.json不会自动保存未保存的文件，调试前必须先按Ctrl+S（Windows/Linux）或Cmd+S（macOS）
最容易被忽略的其实是环境变量的“生效层级”：Node.js 安装时的 PATH、shell 配置里的 npm 设置、VSCode 启动时读取的环境三者必须对齐。断在哪一层，问题就卡在哪一层，不能笼统说“环境没配好”。
