VSCode调试Node.js断点不生效主因是node未被识别、program路径错误或sourceMap未启用：需在集成终端验证node -v，确保launch.json中program指向真实JS文件（如"${workspaceFolder}/index.js"），TS项目须开启sourceMap并配outFiles。
VSCode 写 Node.js 后端，**不需要额外装调试包**——只要 Node.js 已安装（v14+），VSCode 1.70+ 自带 vscode-js-debug，断点就能用。装了反而可能冲突。
为什么断点不生效？先查这三件事
断点显示空心圆、点击无反应、F5 启动后直接跑完没停住，大概率是下面某个环节断了：
-
node -v在 VSCode 集成终端里执行失败 → 检查 PATH 或重启 VSCode（尤其用了nvm/fnm） -
.vscode/launch.json里program路径写错，比如写成./src/index.ts却没配ts-node - 项目在 WSL/Docker 里运行，但
launch.json用的是 Windows/macOS 主机路径 → 调试器找不到源码映射
launch.json 中 program 和 runtimeExecutable 到底怎么选
这两个字段决定谁来“真正启动进程”，选错就等于让调试器连错人：
- 直接跑 JS：用
program，例如"program": "${workspaceFolder}/index.js" - 跑 TypeScript：必须设
runtimeExecutable指向ts-node，并用runtimeArgs传参，program反而变成要执行的 TS 文件路径 - 用
esbuild-node或tsx：同理，runtimeExecutable填可执行命令（如npx或绝对路径），args传入口文件 - 误把
runtimeExecutable设成node，又同时写program→ 会报Cannot launch program because corresponding JavaScript cannot be found
用 nodemon 热重载时断点失效？关键在 --inspect-brk
nodemon 默认不开启调试端口，断点自然连不上。必须让它启动时带上调试参数：
- 不要只写
"runtimeExecutable": "nodemon"，得加--inspect-brk并确保它作用于目标文件 - 推荐写法：
"runtimeExecutable": "${workspaceFolder}/node_modules/.bin/nodemon"+"runtimeArgs": ["--inspect-brk", "${workspaceFolder}/index.js"] - 如果用全局
nodemon，runtimeExecutable改成"nodemon"，但要确认which nodemon输出路径被 VSCode 终端识别 - 端口冲突常见：
--inspect-brk=9229被其他进程占了 → 改成--inspect-brk=9230并同步更新launch.json的port字段（仅 attach 模式需要）
最常被忽略的一点：TypeScript 项目里 sourceMap 必须为 true，且生成的 .js.map 文件得和 .js 在同一目录；否则断点打在 TS 行，实际停在编译后的 JS 第一行，变量也看不了。
