能跑node命令、npm可用、F5能断点才算配好；必须在系统终端执行node -v和npm -v均输出版本号才过关，Windows需手动添加C:\Program Files\nodejs到PATH并重启VSCode，macOS/Linux需确认shell配置已生效且which node路径在$PATH中。
能跑 node 命令、npm 可用、F5 能断点，才算配好——其余全是可选项。
验证 node 和 npm 是否真可用
很多人卡在“VSCode 里 node -v 报错”，却去查插件或 launch.json，浪费半天。根本问题不是 VSCode，而是系统环境没生效。
- 必须在系统终端（macOS 的 Terminal.app、Windows 的 PowerShell/cmd）里执行
node -v和npm -v，两者都输出版本号才算过关 - Windows 安装时漏选
Add to PATH？手动把C:\Program Files\nodejs加进系统环境变量Path，然后彻底关掉所有 VSCode 窗口再重开 - macOS/Linux 用
nvm？确认source ~/.zshrc（或~/.bash_profile）已写入，并新开终端验证which node输出路径是否在$PATH中 - VSCode 内置终端不继承 shell 配置？重启 VSCode 后仍失败，就直接在终端里手动执行
source ~/.zshrc临时补救
launch.json 中 program 字段别写死
VSCode 自动生成的 launch.json 默认是 "program": "${workspaceFolder}/app.js"，但你项目入口可能是 index.js 或 server.js，一换文件就 F5 失败。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 单文件调试：用
"program": "${file}"，这样无论当前打开哪个.js文件，F5 都运行它 - 固定入口：明确写成
"program": "${workspaceFolder}/index.js"，但务必确保该文件存在且已保存 - 调试前按
Ctrl+S（Windows/Linux）或Cmd+S（macOS）——VSCode 默认不自动保存，未保存的断点不会命中 - 想跑
npm start？改成"program": "npm"，加"args": ["start"]和"console": "integratedTerminal"，否则看不到启动日志
npm 全局工具和镜像要提前配好
国内不配镜像，npm install 卡住是常态；全局模块装默认路径，C 盘爆满也常见。
- 换淘宝镜像：
npm config set registry https://registry.npmmirror.com - 改全局安装路径（比如 D 盘）：
npm config set prefix "D:\npm-global"，再把该路径加进系统PATH - 验证配置：
npm config get prefix和npm config get registry必须输出你设的值 - 重装全局工具：
npm install -g nodemon，否则nodemon app.js在 VSCode 终端里仍会报command not found
别装过时的 Node.js 调试插件
Node.js Extension Pack、Debugger for Node.js 这类插件现在已废弃，VSCode 自带 vscode-js-debug 就够用，装了反而可能冲突。
- 确认
node -v成功后，新建index.js写console.log('ok'); -
Ctrl+Shift+P→ 输入Debug: Open Configuration→ 选Node.js → Current File - 生成的
launch.json里若出现"type": "pwa-node"是新版，没问题；若还是"type": "node"也不用动，照样能断点 - 如果 F5 提示
Cannot find runtime 'node'，100% 是第一步的环境没配对，不是 launch.json 写错了
最常被忽略的其实是：VSCode 终端是否真正加载了你 shell 里的 PATH 和 npm 配置。哪怕 node -v 在系统终端能跑，VSCode 里失败，大概率就是这一步断了。别急着改配置，先关干净、重开、再验证。
