能跑 node -v 且 vscode 能断点调试才算真正搭好；必须在系统终端执行 node -v 和 npm -v 均输出版本号，再配置正确 launch.json（program 字段指向真实入口文件），断点才生效。
能跑 node -v 且 VSCode 能断点调试，才算真正搭好；其余全是锦上添花。
验证系统级 Node.js 是否真可用
很多人卡在“VSCode 报错找不到 node”，其实问题根本不在 VSCode —— 是系统 PATH 没配对。必须在系统终端（不是 VSCode 内置终端）里执行：
node -vnpm -v
两者都输出版本号才算过关。如果报 'node' 不是内部或外部命令：
- Windows：重装 Node.js LTS 版，安装时务必勾选 “Add to PATH”；若已装过，手动把
C:\Program Files\nodejs（或你实际的安装路径）加进系统环境变量Path，然后关掉所有终端窗口再重开 - macOS/Linux：用
nvm的话，确认source ~/.nvm/nvm.sh已写入~/.zshrc或~/.bash_profile，且新终端已加载 - 路径含中文或空格（如
D:\我的软件\nodejs）会导致 npm 静默失败，必须避开
VSCode 调试器不用装插件，但 launch.json 得设对
VSCode 自带 Node.js 调试支持，Node.js Extension Pack 这类插件现在已过时，装了反而可能冲突。只需三步：
Rydberg Agent 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'：一定是node -v在系统终端都失败，不是配置问题 - 调试时提示 “无法启动程序”：检查
launch.json中"program"是否指向了真实存在的入口文件（比如你主文件叫app.js，就得改成"${workspaceFolder}/app.js"） - 没保存就点 F5：VSCode 不会自动保存，调试前务必按
Ctrl+S
全局 npm 工具（如 nodemon）在 VSCode 终端里用不了？PATH 没继承
你在 CMD 或 Terminal 里能用 nodemon，但在 VSCode 终端里提示 command not found，大概率是 VSCode 没读到你 shell 的环境变量。
- 如果你改过 npm 全局路径（例如执行过
npm config set prefix "D:\npm-global"），必须把该路径加进系统Path变量 - 改完后关闭并重开整个 VSCode（不只是重启终端），否则它不会重新读取 PATH
- macOS/Linux 用户可在 VSCode 终端里手动执行
source ~/.zshrc快速加载配置，但更稳妥的是确保 shell 配置已自动加载
国内开发建议提前配好镜像和路径：
npm config set registry https://registry.npmmirror.com-
npm config set prefix "D:\npm-global"（Windows）或~/npm-global（macOS/Linux） - 配完验证：
npm config get registry和npm config get prefix
最常被忽略的一点：VSCode 内置终端是否真正继承了你 shell 里生效的全部环境变量。不要假设“系统终端能用，VSCode 就一定行”——它不自动同步 PATH 变更，也不自动 source 你的 shell 配置文件。
