VSCode后端断点不生效,主因是未启动调试会话(F5/▶️)或配置错误;需确认实心红点、正确type、--inspect参数、sourceMaps配置及跳过文件设置。

VSCode 后端调试断点不生效,90% 是因为没走调试协议——点红点只是标记位置,不启动调试会话(F5 或 ▶️)就等于没按开关。
断点为什么点了却不停?先确认调试器真连上了
实心红点 ✅ 才表示断点已绑定;空心红点 ❌ 就是“Unbound breakpoint”,常见原因有:
- 没按 F5 或没点调试图标 ▶️,只点了右上角绿色三角(那是 Code Runner,不进调试器)
- 底部状态栏没出现「调试正在运行」字样,说明 launch.json 配置失败或未选中配置项
- Node.js 项目 type 写成
"pwa-node"(旧扩展写法),但你用的是内置js-debug,应统一为"node" - Python 项目没装
ms-python.python扩展,或解释器没在设置里正确指定
Fastify/Node.js 服务必须加 --inspect 才能触发断点
Fastify 本身不开启 V8 Inspector,--inspect 缺失会导致断点静默失效——程序照跑、无报错、也不停。
- 推荐用 attach 模式:启动命令加
node --inspect=0.0.0.0:9229 -r ts-node/register/transpile-only src/index.ts(TypeScript)或node --inspect=0.0.0.0:9229 src/index.js(JS) -
--inspect=0.0.0.0:9229别简写成--inspect,否则 Docker/WSL 下 VSCode 连不上 -
launch.json中port必须和启动命令一致(如 9229),别填错成 9228 或 9230 - 加
"restart": true可让 VSCode 在 nodemon / ts-node-dev 重启后自动重连
TypeScript 项目断点跳到 .js 文件?sourceMaps 和 outFiles 必须配对
你在 src/index.ts 打断点,结果停在 dist/index.js 且变量名乱码,说明 source map 映射失败。
-
tsconfig.json中必须设"sourceMap": true(禁用"inlineSourceMap": true,VSCode 更认独立.map文件) -
launch.json里显式启用:"sourceMaps": true -
"outFiles"要精准指向编译产物路径,如"${workspaceFolder}/dist/**/*.js",不能写成"**/*.js" - 多包项目(如
packages/foo/src)需加"resolveSourceMapLocations",否则 VSCode 不知道该映射回哪个源目录
条件断点别写副作用表达式,作用域也有限制
右键断点 → Add Conditional Breakpoint 很方便,但实际容易翻车:
- 条件表达式只能读,不能改状态:
i++、console.log()、arr.pop()都不准写,调试器不保证执行顺序 - 只能访问当前作用域变量,不能跨函数引用局部变量(比如在循环外定义的
user,进函数后就不可见) - 字符串比较要小心类型:
id === "123"比id == 123更安全,避免隐式转换误判 - 高频循环里慎用,每次命中都要求值,可能拖慢调试体验
最常被忽略的一点:node_modules/fastify 默认被跳过,如果你在 Fastify 源码里打的断点(比如想看插件加载逻辑),得手动在 launch.json 加 "skipFiles": [" 并删掉 node_modules 相关排除项,否则断点根本不会加载。











