VSCode调试Node.js失败90%因node命令不可达或program路径错误；必须先验证终端中node -v可用，再确保program为${workspaceFolder}开头的绝对路径，TypeScript项目需配sourceMaps或ts-node，Web服务推荐attach模式。
VSCode 本身不运行 Node.js，它只负责启动、连接和调试；真正执行服务的是你本地安装的 node 进程。关联失败的绝大多数情况，不是配置写错了，而是 node 命令根本没进 VSCode 终端的环境变量里——这点必须先确认，否则所有后续操作都是徒劳。
node 命令在 VSCode 终端里是否真可用？
这不是“系统终端能跑就算数”的问题。VSCode 内置终端（Ctrl + `）可能用的是 PowerShell（Windows）、zsh（macOS）或 bash（Linux），而你的 node 路径很可能只加在某个 shell 的初始化文件里，没被 VSCode 加载。
- 在 VSCode 终端里直接运行
node -v和npm -v，必须有输出（如v20.11.1、10.5.0）；报command not found就停在这一步，别往下配launch.json - macOS/Linux：检查
~/.zshrc或~/.bash_profile是否含export PATH="/opt/homebrew/bin:$PATH"（Homebrew 安装路径）或/usr/local/bin（手动安装路径）；改完后执行source ~/.zshrc，再彻底退出 VSCode，从终端用code .启动 - Windows：重装 Node.js 时务必勾选
Add to PATH；或者手动把C:\Program Files\nodejs\加进“系统变量 > PATH”；改完后必须彻底关闭所有 VSCode 进程再重开
launch.json 中 program 字段怎么写才有效？
program 是调试器找入口的唯一依据，它必须指向一个真实存在的、能被 node 直接执行的 .js 文件。写错路径、混用源码和编译产物、漏掉 ${workspaceFolder}，断点就会变灰、调试器提示 “Cannot find module” 或 “Cannot launch program”。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 后端项目不要用
"program": "${file}"（仅适合单文件临时测试）；应显式写成"program": "${workspaceFolder}/app.js"或"program": "${workspaceFolder}/src/server.js" - TypeScript 项目：
program必须指向编译后的.js文件（如dist/server.js），不能指src/server.ts；同时确保tsconfig.json含"sourceMap": true，且.js.map和.js在同一目录 - ESM 项目：必须在
package.json里加"type": "module"，否则import语句会按 CommonJS 解析失败 - 务必加上
"cwd": "${workspaceFolder}"，否则require('./config')、读取.env、静态资源路径都会出错
用 nodemon 热重载时怎么保持断点有效？
直接把 program 改成指向 nodemon 脚本，会导致调试器无法稳定附加，断点跳过、连接中断是常态。nodemon 不是替代 node 的运行时，而是进程管理器——调试必须走 attach 模式。
- 终端先手动运行：
nodemon --inspect-brk src/server.js（端口默认 9229） - 在
launch.json新增一个request: "attach"配置，例如：{ "type": "node", "request": "attach", "name": "Attach to nodemon", "port": 9229, "address": "localhost", "restart": true } - 不要在
launch.json里设runtimeExecutable指向nodemon；旧版教程里那种写法在 VSCode 1.85+ 已不可靠 - 如果项目用
ts-node，优先用"type": "pwa-node"+runtimeExecutable: "npx"+runtimeArgs: ["ts-node", "src/server.ts"]，比硬配nodemon更稳
最常被忽略的一点：VSCode 调试器对路径是字面量敏感的。"./src/server.js" 和 "src/server.js" 都不会被解析为工作区相对路径，只有 "${workspaceFolder}/src/server.js" 才行。哪怕多一个空格、少一个斜杠，断点就失效——这不是 bug，是设计如此。
