能跑 node -v 和 npm -v，且 VSCode 内置终端里也能执行成功，才算 Node 环境真正就位——验证必须在彻底退出 VSCode 后，于系统原生终端确认 which node 或 where node 路径正确，再重启 VSCode 并在内置终端复测，否则调试器因读取旧 PATH 快照而失败。
能跑 node -v 和 npm -v，且 VSCode 内置终端里也能执行成功，才算 Node 环境真正就位——其余所有配置都建立在这个前提上。
验证 node 和 npm 是否真被系统识别
很多人卡在“明明装了却调试不了”，根源是环境变量没生效。关键不是“安装过”，而是“当前所有终端（包括 VSCode 启动时加载的）都能调用到”。
- 关闭所有 VSCode 窗口，**彻底退出进程**（macOS 右键 Dock 图标选「退出」；Windows 在任务管理器中确认
Code.exe已结束） - 打开系统原生终端（不是 VSCode 里的 Terminal），运行：
which node（macOS/Linux）或where node（Windows），确认路径指向你安装的 Node.js（如/usr/local/bin/node或C:\Program Files\nodejs\node.exe） - 再启动 VSCode，按
Ctrl+`打开内置终端，立刻执行node -v和npm -v—— 这次的结果才代表 VSCode 能真正调用 - Windows 用户若装在含中文或空格路径（如
D:\我的软件\nodejs），npm可能静默失败，必须重装到纯英文无空格路径
launch.json 中 program 字段怎么填才不踩坑
program 指定的是要启动的 JS 入口文件，但默认生成的 "program": "${file}" 只适合单文件调试，实际项目结构稍一复杂就失效。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 项目有明确入口（如
src/app.js或index.js），直接写死路径："program": "${workspaceFolder}/src/app.js" - 想用
npm start启动？别改program为"npm"，而是改成："program": "${workspaceFolder}/node_modules/.bin/npm"（Linux/macOS）或"program": "${workspaceFolder}/node_modules/.bin/npm.cmd"（Windows），并加"args": ["start"]和"console": "integratedTerminal" - 用
nodemon？不能用launch模式直接跑，必须切到attach模式：先命令行执行nodemon --inspect-brk index.js，再在launch.json中配"request": "attach"、"port": 9229
调试时提示 Cannot find runtime 'node' 怎么办
这不是 VSCode 设置问题，而是底层根本找不到 node 可执行文件——和 launch.json 内容无关，只和环境变量有关。
- VSCode 启动时读取的是它启动那一刻的系统 PATH，不是你后来在终端里
export的临时变量 - macOS/Linux 用
nvm的，确保source ~/.nvm/nvm.sh已写入~/.zshrc（或~/.bash_profile），且新终端已加载 - Windows 用户检查系统环境变量 Path 是否包含 Node.js 安装目录（如
C:\Program Files\nodejs），修改后必须重启 VSCode 才生效 - 不要依赖 VSCode 内置终端里手动
export PATH=...，那只是当前会话有效，对调试器无效
真正容易被忽略的是：VSCode 调试器启动时，不会重新加载 shell 配置，它只认启动那一刻的环境变量快照。哪怕你在终端里 node -v 成功了，VSCode 也可能还在用旧 PATH。这点不厘清，所有后续配置都是徒劳。
