VSCode本身不提供Node.js运行环境，必须先在系统级安装Node.js并确保PATH正确配置；验证需在CMD/PowerShell中执行node -v和npm -v输出版本号，若失败则重装时务必勾选“Add to PATH”或手动添加路径，之后彻底重启VSCode。
VSCode 本身不带 Node.js，所谓“连接本地 Node 环境”，本质就是让 VSCode 的终端和调试器能调用到你系统里装好的 node 命令——只要这一步通了，后续运行、调试、npm 都自然可用。
确认 node 和 npm 在系统终端能执行
别跳过这步。很多人卡在 VSCode 里报错，其实根本没在系统级验证过安装是否真成功。
- 打开 Windows 的 CMD 或 PowerShell（不是 VSCode 终端），输入
node -v和npm -v - 必须同时输出版本号，比如
v20.15.1和10.7.0；如果提示“不是内部或外部命令”，说明 Node.js 根本没进系统 PATH - Windows 用户最常见错误：安装 .msi 包时漏勾了 “Add to PATH” —— 不是重配 VSCode 能解决的，得重装或手动把
C:\Program Files\nodejs\加进系统环境变量 PATH - 加完 PATH 后，必须关闭所有已打开的 CMD/PowerShell 和 VSCode 进程，再全新启动
让 VSCode 继承正确的 PATH
即使系统终端能跑 node，VSCode 内置终端仍可能找不到，因为它的启动方式常绕过 shell 初始化逻辑。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 在 VSCode 里按
Ctrl + `打开内置终端，立刻执行where node（Windows）或which node（macOS/Linux） - 如果没输出或路径不对，说明 VSCode 没读到你配好的 PATH
- Windows：重装 Node.js 并务必勾选 “Add to PATH”；或者手动把
C:\Program Files\nodejs\加入“系统变量”里的 PATH，然后彻底退出 VSCode 再重启 - macOS/Linux：检查
~/.zshrc或~/.bash_profile是否导出了 Node 路径（如export PATH="/opt/homebrew/bin:$PATH"），改完后必须重启 VSCode，source文件不够
调试前必须验证 launch.json 的 program 字段
VSCode 调试器靠 program 字段定位入口文件，写错路径或变量，断点直接失效，且不会报明显错误。
- 确保你是通过 “文件 → 打开文件夹” 打开整个项目（含
package.json或主 JS 文件），而不是只打开单个.js文件 -
launch.json中"program"必须是相对于${workspaceFolder}的完整路径，例如："${workspaceFolder}/app.js"，不能写成./app.js或app.js - 如果你用的是 ESM 项目，
package.json中必须有"type": "module"，否则import会报错，调试器也加载失败 - 不想被
node_modules干扰断点？在配置里加一行："skipFiles": []
别依赖 Code Runner 插件跑 Node 脚本
它默认命令太简陋，不处理模块类型、编码、输入流，尤其在 ESM 或中文路径下容易假死或报错。
- 用 VSCode 内置终端（
Ctrl + `）手动执行node app.js，行为和真实部署环境一致 - 如果要用 Code Runner，至少在设置中修改
code-runner.executorMap的javascript条目：
ESM 项目："node --experimental-specifier-resolution=node $fileName"
Windows 中文路径防乱码："node -r utf-8 $fileName" - 遇到
process.stdin就卡住？Code Runner 不支持交互式输入，换调试模式（F5）或终端手动跑
最容易被忽略的一点：改完环境变量或安装新版本 Node 后，VSCode 必须完全退出再重开，只关终端或重载窗口无效。断点不命中、command not found、调试时报 “Cannot launch program”，90% 都卡在这一步没走通。
