能跑 node -v 和 npm -v 且 VSCode 按 F5 可断点调试，才算环境真正搭好；必须在系统终端而非 VSCode 内置终端验证，若报“node 不是内部或外部命令”说明 PATH 未配置，npm -v 成功比 node -v 更关键，因 VSCode 调试器依赖它启动。
能跑 node -v 和 npm -v，且 VSCode 按 F5 就能断点调试，才算环境真正搭好——其余全是可选。
验证 node 和 npm 是否真可用（别跳过这步）
很多人卡在调试失败，结果发现是系统根本找不到 node 命令。关键不是 VSCode 有问题，而是终端里就执行不了 node -v。
- 必须在系统终端（Windows 的 CMD/PowerShell、macOS/Linux 的 iTerm/Terminal）里运行，不是 VSCode 内置终端
- 如果报错
'node' 不是内部或外部命令，说明 Node.js 没进 PATH：Windows 安装时漏勾了Add to PATH；macOS/Linux 用nvm的，得确认source ~/.nvm/nvm.sh已写入~/.zshrc或~/.bash_profile，并新开终端加载 - Windows 用户务必避开中文路径和空格路径（如
D:\我的软件\nodejs），否则npm可能静默失败 -
npm -v成功比node -v更关键：VSCode 调试器底层靠它启动脚本，失败则调试直接报Cannot find runtime 'node'
VSCode 内置调试器直接可用，无需装 Node.js 插件
VSCode 自带 Node.js 调试支持，Node.js Extension Pack 或 Debugger for Node.js 这类插件现在已过时，装了反而可能冲突。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 新建一个文件夹，在里面创建
index.js，写一行console.log('ok'); - 按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入Debug: Open Configuration，选择Node.js → Current File - VSCode 会自动生成
.vscode/launch.json，其中"program": "${file}"表示运行当前打开的 JS 文件 - 在行号左侧单击设断点，按
F5启动——如果提示Cannot find runtime 'node'，一定是上一步环境没配好，不是配置问题
launch.json 配置常见陷阱（npm start / nodemon 场景）
默认生成的配置只适合单文件调试，实际开发中很容易踩坑。
- 想调试
npm start？把"program"改成"npm"，"args"设为["start"]，并加"console": "integratedTerminal"，否则看不到 npm 输出 - 用
nodemon热重载？不能直接在launch.json里调nodemon——VSCode 调试器不支持进程热替换，必须用attach模式：
先在终端运行nodemon --inspect-brk index.js，再在launch.json中配置"type": "node"、"request": "attach"、"port": 9229 - 注意端口：现代 Node.js 默认调试端口是
9229，不是旧文档里的9223或5858
为什么推荐 nvm / nvm-windows 而非官网安装包
多项目常需不同 Node.js 版本，比如一个用 v16.20（LTS），另一个要 v20.15（最新稳定版）。官网安装包只能全局换一次，而 nvm 可以 per-project 切换。
- macOS/Linux：装
nvm后，进项目目录执行nvm use 16.20，node -v和npm -v就立刻切换 - Windows：用
nvm-windows，注意它不兼容 PowerShell 默认配置，建议改用 CMD 或启用nvm的 PowerShell 支持 - VSCode 内置终端若未加载
nvm，可在设置里把terminal.integrated.defaultProfile.linux（或对应平台）指向正确 shell，并确保 shell 配置文件已 sourcenvm.sh
最常被忽略的其实是环境变量加载时机和终端上下文隔离——VSCode 内置终端是否继承了你 shell 的 PATH，和系统终端是否一致，这点不验证清楚，后面所有调试配置都是空中楼阁。
