能跑node命令且VSCode能断点调试才算真正搭好环境；先在系统终端执行node -v和npm -v验证版本，失败则需修复PATH（Windows勾选Add to PATH或手动添加，macOS/Linux确认nvm配置并重载），再用VSCode内置调试器配launch.json调试当前文件。
能跑 node 命令，且 VSCode 能断点调试，才算真正搭好环境；其余全是可选项。
验证系统终端里 node 和 npm 是否可用
这是所有后续操作的前提，跳过这步，后面全是徒劳。打开系统终端（不是 VSCode 内置终端），执行：
node -v<br>npm -v
两个命令都必须输出版本号。如果报错 'node' 不是内部或外部命令，说明 Node.js 没进系统 PATH：
- Windows 安装时没勾选
Add to PATH？手动把安装目录（如C:Program Files odejs）加进系统环境变量Path，然后彻底关闭并重启 VSCode - Windows 别装在含中文或空格的路径下（如
D:我的软件 odejs），npm可能静默失败 - macOS/Linux 用
nvm？确认source ~/.nvm/nvm.sh已写入~/.zshrc或~/.bash_profile，且新开终端已加载
npm -v 成功是 VSCode 调试器正常工作的硬性前提——它底层靠 npm 启动脚本，不是可配可不配的选项。
VSCode 内置调试器直接可用，别装过时插件
VSCode 自带 Node.js 调试支持，Node.js Extension Pack 或 Debugger for Node.js 这类插件现在已过时，装了反而可能冲突。
确认 node 可用后，只需三步：
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 新建项目文件夹，在其中创建
index.js，写一行console.log('ok'); - 按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入Debug: Open Configuration，选择Node.js → Current File - VSCode 自动生成
.vscode/launch.json，内容含"program": "${file}"—— 表示“运行当前打开的 JS 文件”
此时在代码行号左侧单击设断点，按 F5 即可启动调试。若提示 Cannot find runtime 'node'，一定是第一步环境没配好，不是 VSCode 设置问题。
launch.json 中常见配置陷阱
默认生成的配置只适合单文件调试，实际开发中容易踩坑：
- 想调试
npm start？把"program"改成"npm"，"args"设为["start"]，并加"console": "integratedTerminal"，否则看不到 npm 输出 - 用
nodemon热重载？不能直接在launch.json里调nodemon——VSCode 调试器不支持进程热替换，必须用attach模式：
先命令行跑nodemon --inspect-brk index.js，再在launch.json中配置"type": "node"、"request": "attach"、"port": 9229 - 系统有多个 Node.js 版本（比如用
nvm）？在launch.json中显式指定"runtimeExecutable"，例如"runtimeExecutable": "/usr/local/bin/node"（macOS/Linux）或"runtimeExecutable": "C:\nodejs\node.exe"（Windows），否则断点可能不触发
别用 Code Runner 插件跑 Node.js 脚本
Code Runner 默认用 node 执行 JS 文件，但它绕过项目上下文，不加载 package.json 中的 type 字段或 exports 配置，容易在 ES Module 场景下报错 Cannot use import statement outside a module。
正确做法是：
- 用 VSCode 内置终端（
Ctrl+`）执行node index.js，行为与真实部署环境一致 - 若项目用了
"type": "module"，确保文件扩展名为.mjs或在package.json中明确声明，否则node会按 CommonJS 解析 -
Code Runner的快捷键（Ctrl+Alt+N）只适合快速验证单文件逻辑，正式开发中应禁用
最易被忽略的是：改完环境变量后没重启 VSCode，导致内置终端仍不可用；还有就是误以为装了插件就等于环境好了，其实连 node -v 都没在系统终端跑通，一切调试都是空中楼阁。
