热重载与断点调试无法同时稳定运行，因nodemon重启整个Node进程导致VSCode断点失效；正确做法是采用attach模式配合--inspect-brk固定端口，并确保代码支持高频重启。
不能一边热重载一边稳定断点调试。nodemon 重启的是整个 Node 进程，VSCode 的断点在新进程里默认不生效；所谓“增量调试”是误称——Node.js 后端没有 HMR（热模块替换），只有进程级重启。真要调试，得在重启间隙设断点，或改用 attach 模式让 VSCode 主动连新进程。
为什么 launch 模式配 nodemon 总报 ECONNREFUSED 或 ENOENT
常见错误是直接写 "runtimeExecutable": "nodemon"：它会去系统 PATH 找，但本地安装的 nodemon 在 node_modules/.bin/nodemon，Windows 下还有 .cmd 扩展名问题，导致找不到命令。
- 正确做法是用
"runtimeExecutable": "npm"+"runtimeArgs": ["run", "debug"]，前提是package.json里有"debug": "nodemon --inspect-brk ./src/server.js"这类脚本 - 别把入口路径硬编码进
launch.json的program字段——runtimeArgs已经传了，再设program会导致参数冲突 - 如果坚持用
runtimeExecutable指向本地 bin，macOS/Linux 写"${workspaceFolder}/node_modules/.bin/nodemon"，Windows 必须写成"${workspaceFolder}/node_modules/.bin/nodemon.cmd"
attach 模式才是稳定调试的唯一可行路径
VSCode 不控制启动，只监听端口并重连，规避了所有路径、权限、进程生命周期问题。但前提是 nodemon 必须带 --inspect 或 --inspect-brk 启动，且端口固定。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
-
package.json脚本示例："debug": "nodemon --inspect-brk=9229 --watch src --ext js,cjs,json ./src/server.js" -
launch.json配置关键项："request": "attach"、"port": 9229、"restart": true、"protocol": "inspector" - 必须先在终端运行
npm run debug，等看到Debugger listening on ws://127.0.0.1:9229/再点 VSCode 的「开始调试」——restart: true只在首次 attach 成功后才起作用 -
--inspect-brk不是为了让断点“停住”，而是让人眼确认 nodemon 进程已就绪；attach 后 VSCode 会自动 resume，你随时可设新断点
热重载期间哪些事会出错
文件一改就重启，不代表逻辑能正确执行。很多问题不是配置错，而是代码本身不兼容热重启。
- 数据库连接、Redis 客户端、WebSocket server 等初始化逻辑写在模块顶层，每次重启都新建实例，容易触发 EADDRINUSE 或连接泄漏
-
--watch src比--watch .安全，否则node_modules或dist目录下临时文件变动也会触发重启 -
--ext必须覆盖你实际修改的扩展名：用.cjs就加cjs，用.ts就得配ts-node并加ts，否则改了文件不重启 - 改完
package.json或入口文件后没按 Ctrl+S 落盘，nodemon 监听的是磁盘文件，不是编辑器内存状态
真正难处理的从来不是怎么配 launch.json，而是让服务代码本身能承受高频重启——比如把连接池、定时器、监听器的销毁逻辑补全，而不是依赖进程退出自动回收。
