VSCode调试Node.js失败的根本原因是环境变量未正确继承和launch.json配置不当。需确保终端中node -v可用，program字段指向有效JS文件，并根据ESM、TS或打包项目正确配置sourceMaps和入口路径。
VSCode 本身不带 Node.js，它只负责“调用”和“调试”，真正执行 JS 的是系统里装好的 node 命令——两者是独立进程、松耦合关系，不是捆绑包。
为什么 VSCode 终端里 node -v 成功，但调试却报 Cannot find runtime 'node'？
这是环境变量继承问题，不是配置错误。VSCode 启动方式（比如从 Dock 或开始菜单点开）常绕过 shell 初始化文件（~/.zshrc 或 PATH 系统变量），导致内置终端找不到 node。
- macOS/Linux：在终端执行
which node，确认路径（如/opt/homebrew/bin/node）已写进~/.zshrc的export PATH="...:$PATH"；改完必须重启 VSCode，或直接从终端启动：code --no-sandbox . - Windows：检查系统环境变量
Path是否包含C:\Program Files\nodejs\；若不确定，重装 Node.js 并务必勾选 “Add to PATH” - 验证标准：在 VSCode 内置终端（
Ctrl+`）里输入node -v和npm -v都有输出，才可继续配launch.json
launch.json 中的 program 字段到底该怎么填？
它不是“告诉 VSCode 用哪个解释器”，而是“告诉调试器从哪加载 JS 文件并传给 node 进程”。路径错、变量没展开、文件不存在，断点全灰。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 单文件调试：用
"program": "${file}"—— 安全，只对当前打开的 JS 文件生效 - 固定入口（如
index.js）：写绝对路径"program": "${workspaceFolder}/index.js"，别漏斜杠，别拼错文件名 - 运行 npm 脚本（如
npm start）：不能设program为npm，得改成："program": "npm"+"args": ["start"]+"console": "integratedTerminal" - 用
nodemon热重载？别在launch.json里直接跑它——调试器不支持热替换，必须用 attach 模式：nodemon --inspect-brk index.js启动后，在launch.json中配"type": "node"、"request": "attach"、"port": 9229
断点不命中，真的是代码写错了吗？
大概率不是。Node.js 调试器依赖源映射（source map）对齐原始代码与实际执行代码，而 ESM、打包、TS 编译等场景极易破坏这个对齐。
- ESM 项目：确保
package.json有"type": "module"，且launch.json中开启"sourceMaps": true - TypeScript 项目：编译时生成
.map文件，并在tsconfig.json中设"sourceMap": true，launch.json的program指向编译后的.js文件，而非.ts - Webpack/Vite 打包项目：调试前确认 devtool 设为
source-map或inline-source-map，且launch.json的program是最终产出的入口 HTML 或 JS 文件路径 - 清掉干扰项：删掉
launch.json中的"skipFiles"（默认可能跳过node_modules和内置模块），或显式设为空数组[]
最常被忽略的点：VSCode 调试器根本不管你的 package.json 或 npm scripts 是怎么写的，它只认 program 指向的那个文件是否存在、能否被 node 加载。哪怕你 npm start 能跑通，F5 调试失败也完全正常——因为两者走的是不同执行路径。
