能跑 node -v 和 npm -v 且 vscode 内置终端、调试器均可直接调用才算稳定；关键在系统终端（cmd/terminal）中两者均输出版本号，windows 常因未勾选 add to path，macos/linux 需确认 nvm 路径已正确加载并重启 vscode。
能跑 node -v 和 npm -v，且 VSCode 内置终端、调试器都能直接调用，才算稳定；其余插件、格式化、TypeScript 都是后续优化项，不是稳定性的判断依据。
验证 node 和 npm 是否真正可用
很多人卡在“VSCode 调试失败”，实际是系统级环境没配好。关键不在 VSCode，而在终端能否全局识别命令：
- 必须在系统终端（Windows 的 cmd/PowerShell、macOS/Linux 的 Terminal）中执行
node -v和npm -v，两者都输出版本号才算通过 - Windows 安装时漏选
Add to PATH是最常见原因；若已安装，手动把C:\Program Files\nodejs（或你实际的安装路径）加进系统Path变量，然后重启所有终端窗口 - macOS/Linux 用
nvm的，确认source ~/.zshrc（或~/.bash_profile）已写入，并在新终端里执行过；which node应返回 nvm 管理的路径，而非/usr/local/bin/node - VSCode 内置终端可能缓存旧环境变量——关掉所有 VSCode 窗口，重新打开项目文件夹再试
launch.json 中 program 字段别写死
VSCode 自动生成的 launch.json 默认设为 "program": "${workspaceFolder}/app.js"，但实际项目入口名千差万别（index.js、server.js、src/index.js），硬编码会导致 F5 直接报错：
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 单文件调试：用
"program": "${file}"，F5 始终运行当前打开的 JS 文件，最灵活 - 固定入口：明确设为
"program": "${workspaceFolder}/index.js"，但务必确保该文件真实存在且有可执行逻辑 - 调试前务必按
Ctrl+S（Windows/Linux）或Cmd+S（macOS）保存文件——VSCode 不会自动保存未提交的修改 - 如果用
npm start启动，不要改program，而是设"program": "npm"+"args": ["start"]+"console": "integratedTerminal"，否则看不到启动日志
npm 全局工具和镜像要提前配好
npm -v 成功只是起点；后续装 nodemon 或跑脚本时出错，往往源于配置缺失：
- 国内必须换镜像：
npm config set registry https://registry.npmmirror.com（当前有效地址） - 避免 C 盘被占满：改全局路径，比如 Windows 下
npm config set prefix "D:\npm-global"，再把该路径加进系统Path - 验证生效：
npm config get prefix和npm config get registry必须输出你刚设的值 - 重装全局工具：
npm install -g nodemon；之后在任意目录执行nodemon index.js应成功——若 VSCode 终端里提示command not found，说明终端没加载 shell 配置，重启 VSCode 或手动执行source ~/.zshrc更快
调试器依赖 npm 启动脚本，不是可选项
VSCode 的 Node.js 调试器底层调用的是 npm 执行的启动流程，不是纯二进制调用。这意味着：
-
npm -v失败 →F5必报Cannot find runtime 'node'，和 launch.json 写法无关 - 用
nodemon --inspect-brk热重载时，不能把nodemon写进program字段——调试器不支持热替换，必须用attach模式："type": "node"+"request": "attach"+"port": 9229 - Windows 用户避开中文/空格路径装 Node.js，否则
npm install可能静默失败（无报错但模块没装上）
真正容易被忽略的，是 VSCode 终端是否继承了你 shell 里已生效的 npm 配置。系统终端能用 nodemon，VSCode 里不能，大概率是 shell 配置没加载，而不是 Node.js 没装好。
