VSCode调试Node.js失败主因是环境变量未加载或路径配置错误：需确保终端中node -v可用、program为绝对路径、TypeScript项目启用sourceMap并正确配置outFiles。
VSCode 本身不提供 Node.js 运行时，所有“配置失败”本质上都是它没找到你系统里已装好的 node 或调用路径不对——先确认这点，再往下调。
node -v 在终端能跑，但调试器报 “Cannot find runtime 'node'”
这不是插件问题，是 VSCode 调试器启动时压根没加载你的 shell 环境变量（比如 ~/.zshrc 或 PATH）。macOS/Linux 用户从 Dock 启动 VSCode 就容易中招；Windows 用户则常因安装时漏选 “Add to PATH”。
- 验证方式：在 VSCode 内置终端（
Ctrl + `）里直接执行node -v，有输出才算真正可用 - macOS/Linux：改完
~/.zshrc后，必须彻底退出 VSCode 所有进程，再从终端运行code .启动 - Windows：打开「系统属性 → 高级 → 环境变量」，检查系统变量
Path是否包含C:\Program Files\nodejs\；若含空格或路径错误（如C:Program Files odejs），手动修正 - 临时绕过：在
.vscode/settings.json中注入环境变量："terminal.integrated.env.windows": { "PATH": "C:/path/to/node;${env:PATH}" }，注意路径用正斜杠或双反斜杠，且必须保留${env:PATH}
launch.json 的 program 字段总报 “Cannot launch program”
这个错误几乎全是路径写错，调试器只认真实存在的、可执行的 JS 文件，不认源码、命令、相对路径语法或不存在的文件。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
-
program必须是绝对路径表达式，推荐写成"${workspaceFolder}/dist/index.js"（TypeScript 编译后）或"${workspaceFolder}/index.js"（纯 JS 项目） - 别写
"./src/index.js"或"src/index.js"——.和./在这里不被解析，等同字面量字符串 - TypeScript 项目：不能指向
.ts文件；要么编译后指向dist/下的 JS，要么用runtimeExecutable指向npx ts-node（但断点体验不如 source map） - ESM 项目（
package.json含"type": "module"）：仍填 JS 路径，但需加"runtimeArgs": ["--experimental-specifier-resolution=node"]
断点是空心红圈，点了没反应
空心圈 = VSCode 认为该位置不可打断点，常见原因是 launch.json 缺关键字段、入口文件不是 JS、或 source map 没对上。
- 必须显式声明：
"type": "node"（小写）和"request": "launch"（启动新进程）或"attach"（连已有进程） - TypeScript 项目要三者同时满足：
"sourceMaps": true、"outFiles": ["${workspaceFolder}/dist/**/*.js"]（路径必须和实际构建输出一致）、"resolveSourceMapLocations": ["${workspaceFolder}/src/**", "!**/node_modules/**"] - 检查
tsconfig.json：确保"sourceMap": true，禁用"inlineSourceMap": true（VSCode 更倾向独立.map文件） - 打开「调试控制台」搜
Loaded source map from:，看到 404 就说明outFiles或构建路径错了
最容易被忽略的是：node -v 在终端里能跑 ≠ 调试器能调用；program 指向一个真实 JS 文件 ≠ 断点能停在你写的源码行上——这两层链路都得通，缺一不可。
