能跑 node -v 和 npm -v 且 vscode 按 f5 可断点调试 index.js，关键在于系统 path 正确配置 node.js 和 npm，vscode 调试依赖 npm 启动脚本，而非仅 node；需确保终端中 npm -v 成功，否则调试必失败。
能跑 node -v 和 npm -v，且 VSCode 按 F5 就能断点调试 index.js，整个过程 5 分钟内完成——其余全是干扰项。
验证系统级 Node.js 是否真正可用
很多人在 VSCode 里调试失败，根源是 node 命令根本没进系统 PATH。这不是 VSCode 的问题，而是安装环节漏了关键动作。
- 打开系统终端（Windows 是 CMD/PowerShell，不是 VSCode 内置终端），执行：
node -v和npm -v - 若报错
'node' is not recognized as an internal or external command，说明 PATH 没配好 - Windows 用户：重装 Node.js LTS 版，务必勾选
Add to PATH；若已装错路径（如含中文或空格），建议卸载后重装到C:\nodejs这类纯英文无空格路径 - macOS/Linux 用户：用
nvm安装的，检查~/.zshrc或~/.bash_profile是否包含source ~/.nvm/nvm.sh，并新开终端验证
VSCode 调试器无需插件，三步直接开跑
VSCode 自带 Node.js 调试支持，Node.js Extension Pack、Debugger for Node.js 等插件不仅多余，还可能覆盖默认行为导致 Cannot find runtime 'node' 错误。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 新建文件夹，用 VSCode 打开它（不是直接双击 VSCode 图标）
- 新建
index.js，写一行：console.log('debug test'); - 按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入Debug: Open Configuration→ 选择Node.js → Current File - VSCode 会自动生成
.vscode/launch.json，其中关键字段是："program": "${file}" - 在
console.log行号左侧单击设断点，按F5即可启动调试
launch.json 配置陷阱：别改错字段名
默认生成的配置只适合单文件调试，但稍一改动就容易触发静默失败——尤其当想调试 npm start 或热重载服务时。
- 想运行
npm start？把launch.json中的"program"改成"npm"，"args"设为["start"]，并加"console": "integratedTerminal"，否则看不到 npm 输出 - 用
nodemon？不能把"program"改成"nodemon"—— VSCode 调试器不支持 fork 后替换进程，必须用attach模式：
先终端执行nodemon --inspect-brk index.js，再在launch.json中设"type": "node"、"request": "attach"、"port": 9229 - 常见错误：把
"runtimeExecutable"错写成"runtime"，或漏掉"env"导致环境变量缺失（比如NODE_ENV=development）
最容易被忽略的调试前提：npm -v 必须成功
VSCode 的 Node.js 调试器底层调用的是 npm 启动脚本，不是单纯起一个 node 进程。所以 npm -v 失败 = 调试器启动失败，哪怕 node -v 显示正常也一样。
这个细节几乎没人提，但它决定了你是否会在断点处卡死、F5 后无反应、或者弹出“无法找到运行时”提示——归根结底，不是 launch.json 写得不够花哨，而是 npm 根本没活过来。
