VSCode里node -v报错根本原因是环境变量未继承：macOS/Linux需终端执行code .启动或彻底重启VSCode，Windows需确认Add to PATH并手动添加C:\Program Files\nodejs到系统PATH，验证标准是VSCode内置终端中node -v和npm config get prefix均有输出。

VSCode 里 node -v 报错，不是 VSCode 的问题，而是系统环境根本没通——所有后续配置都得停在这一步。

node -v 在系统终端能跑，但在 VSCode 终端报 command not found

这说明 VSCode 启动时没加载你的 shell 初始化文件（比如 ~/.zshrc 或 ~/.bash_profile），导致它看不到你配的 PATH 和 npm config。

• macOS/Linux：别从 Dock 或 Spotlight 启动 VSCode；在终端执行 code . 打开项目，或彻底重启 VSCode（关掉所有窗口再重开）
• Windows：确认 Node.js 安装时勾选了 Add to PATH；若漏了，手动把 C:\Program Files\nodejs 加进“系统变量”的 Path，然后重启 VSCode
• 验证唯一标准：在 VSCode 内置终端（Ctrl + `）里运行 node -v 和 npm config get prefix，两个都有输出才算过关

launch.json 中 program 字段填什么才不启动失败

填错 program 是调试失败最常见原因，错误不是语法问题，而是路径根本找不到可执行 JS 文件。

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

• 单文件临时调试：用 "${file}" —— 注意不是 ${fileBasename}，它会自动指向当前编辑器打开的文件
• 项目有固定入口（如 index.js 或 server.js）：写成 "${workspaceFolder}/index.js"，确保该路径下真实存在这个文件
• ESM 项目（含 "type": "module"）：不能直接指向 .ts 或未编译源码；必须指向已生成的 .js，且 launch.json 中加 "env": {"NODE_OPTIONS": "--enable-source-maps"}
• 别写相对路径如 "./src/index.js"——如果工作区根目录不在项目顶层，路径会解析错

想用 nodemon 热重载，但 F5 直接报错

VSCode 调试器不支持进程热替换，nodemon 不能直接塞进 program 字段里启动，否则会卡住或报错。

• 正确做法是 attach 模式：先在终端手动运行 nodemon --inspect-brk index.js
• 再在 launch.json 中配："type": "node"、"request": "attach"、"port": 9229
• 注意：--inspect-brk 会让 nodemon 启动后暂停，等 VSCode 连上才继续执行，断点才能命中
• 如果改用 npm start，就别配 program，改用 "runtimeExecutable": "npm" + "runtimeArgs": ["start"]，并加 "console": "integratedTerminal" 看输出

最容易被忽略的其实是环境继承链：shell 配置 → 终端启动方式 → VSCode 启动方式 → launch.json 解析路径。任何一个环节断开，node 就找不见，npm 就装不上，debug 就起不来——它不玄学，只是路径和上下文太容易错位。