能跑 node -v 且断点能停，才算配好了——其余全是锦上添花；需确保系统级 path 正确继承（windows 勾选 add to path，macos/linux 从终端执行 code . 并 source shell 配置），launch.json 中 type 必须为 "node"、program 必须指向真实可执行 .js 文件（如 "${file}" 或 "${workspacefolder}/index.js"），esm 项目还需添加 "env": {"node_options": "--enable-source-maps"}。
能跑 node -v 且断点能停，才算配好了——其余全是锦上添花。
确认 node 和 npm 真正在系统级可用
VSCode 不装 Node.js，它只调用你系统里已有的那个。很多人卡在调试器报 Command "node" not found，其实不是 VSCode 的锅，是 PATH 没进 GUI 进程。
- Windows：重装 Node.js 时务必勾选 Add to PATH；若漏了，手动把
C:\Program Files\nodejs（或你实际安装路径）加进「系统环境变量」的Path，然后关掉所有 VSCode 窗口再重开 - macOS/Linux：用
nvm的话，确保source ~/.nvm/nvm.sh写进了~/.zshrc或~/.bash_profile，且 VSCode 是从终端启动的（code .），否则桌面图标启动的 VSCode 读不到 shell 配置 - 验证方式：在 VSCode 内置终端里运行
which node（macOS/Linux）或where node（Windows），输出路径必须和你在系统终端里执行的结果一致
launch.json 中 program 和 type 别写错
断点不触发、F5 按下没反应，八成是 launch.json 里这两项不对劲。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
-
"type": "node"必须小写，写成"Node"或"NODE"会静默失败 -
"program"填"${file}"最安全，适合单文件调试；填"${workspaceFolder}/index.js"也行，但得确保该路径下真有这个文件，且不是 TypeScript 源码（要指向编译后的dist/index.js） - 如果是 ESM 项目（
package.json里有"type": "module"），还得加"env": {"NODE_OPTIONS": "--enable-source-maps"}，否则断点映射失效
npm 全局工具和镜像别等出问题才配
nodemon、ts-node 这类工具在 VSCode 终端里用不了，往往不是插件问题，而是 npm 配置没继承过去。
- 换国内镜像：
npm config set registry https://registry.npmmirror.com - 改全局安装路径（避免 C 盘爆满）：
npm config set prefix "D:\npm-global"，再把这个路径加进系统PATH - 重装全局工具：
npm install -g nodemon，然后在 VSCode 终端里直接敲nodemon --version验证 - 如果系统终端能用
nodemon，但 VSCode 里报command not found，大概率是终端没加载 shell 配置，重启 VSCode 或手动执行source ~/.zshrc更快
调试 npm script 或热重载时别硬套 launch
想调试 npm start 或用 nodemon，直接改 program 字段是错的——VSCode 调试器不支持进程替换。
- 调试
npm start：设"runtimeExecutable": "npm"，"runtimeArgs": ["start"]，并加"console": "integratedTerminal"，否则看不到日志 - 用
nodemon热重载：先终端执行nodemon --inspect-brk index.js，再在launch.json里配"request": "attach"+"port": 9229 - 别在
launch.json里写死runtimeExecutable路径（比如/Users/xxx/.nvm/versions/node/v18.19.1/bin/node），这会让团队协作崩溃；用nvm use+ 从终端启动 VSCode 才可持续
最常被忽略的其实是：VSCode 终端是否真的读到了你 shell 里生效的 PATH 和 npm config。很多“配置失败”现象，本质是 GUI 启动的 VSCode 没加载 shell 初始化脚本——这点不厘清，后面所有配置都白搭。
