断点失效主因是launch.json配置错误:program必须指向真实可执行的.js文件(如${workspaceFolder}/dist/index.js),而非.ts源码;需确保sourceMap启用、outFiles路径精确匹配,且调试器类型与扩展一致。

断点失效不是代码问题,而是调试链路没接通——launch.json 配置错一个字段,VS Code 就会静默跳过所有断点,红点变空心、程序飞快跑完、底部没出现「调试正在运行」,都是典型信号。
为什么 launch.json 里 program 指向 .ts 文件就失效
VS Code 调试器实际执行的是 JavaScript,不是 TypeScript。program 字段必须指向真实可执行的 .js 文件(如 ${workspaceFolder}/dist/index.js),不能是 .ts 源码。否则调试器要么尝试直接运行 TS(失败),要么降级为无符号解释执行(断点无法绑定)。
-
program写成"${workspaceFolder}/src/index.ts"→ 必然失效 - 正确写法是
"${workspaceFolder}/dist/index.js",且确保该文件真实存在 - 若坚持用
.ts入口,必须配合ts-node并在runtimeArgs中加--loader ts-node/esm(ESM 项目)或--transpile-only(CommonJS) - 构建产物路径必须和
outFiles一致,否则调试器找不到 JS 文件来加载 source map
sourceMap 映射失败:空心断点的真正原因
空心圆 ≠ 断点没设,而是调试器识别到位置,但无法把 dist/index.js 的某一行映射回 src/index.ts。本质是 source map 链路断裂。
-
tsconfig.json必须含"sourceMap": true,且"outDir"明确(不能是"./"或空) -
launch.json中必须显式写"sourceMaps": true(默认值不可靠) -
outFiles要精确 glob 到 JS 输出路径,例如["${workspaceFolder}/dist/**/*.js"];写成["./dist/**"]或["dist//**/*.js"]都会失败 - 检查
dist/index.js末尾是否有//# sourceMappingURL=index.js.map,且同目录下index.js.map文件真实可读
Node.js 调试连不上进程:inspect 参数没生效
手动在终端执行 npm start 后再点 VS Code 的「Attach」,90% 失败——因为默认不带 --inspect-brk,Node 进程根本没暴露调试端口。
- 优先用
"request": "launch",让 VS Code 自己启动进程并注入--inspect-brk=9229 - 避免
"request": "attach",除非你已在脚本中显式加了--inspect-brk -
"type": "node"必须小写,"pwa-node"是旧插件写法,新版@vscode/js-debug不认 - 确认 VS Code 内置终端能执行
node -v;若失败,需在.vscode/settings.json中补全PATH,例如"terminal.integrated.env.osx": {"PATH": "/opt/homebrew/bin:$PATH"}
Python / C++ / Java 等语言的共性陷阱
不同语言底层机制不同,但断点失效的根因高度一致:符号未加载、路径未对齐、调试器未 attach 成功。
- Python:
"module": "myproject.cli"比"program": "./src/main.py"更可靠,尤其在包结构或框架场景下;python.defaultInterpreterPath必须指向虚拟环境里的解释器 - C/C++:编译命令必须带
-g(GCC/Clang)或/Zi(MSVC);launch.json中miDebuggerPath要指向真实gdb或lldb可执行文件 - Java:Spring Boot 热部署时,JVM 里跑的可能是旧字节码,
vmArgs缺少-XX:HotswapAgent或-Dspring.devtools.restart.enabled=true会导致断点位置错位 - 所有语言都受
"justMyCode": true影响——它默认跳过非工作区导入的模块,想进flask或express源码,必须设为false
最常被忽略的一点:launch.json 不是“写完就能用”的配置文件,它是调试会话的唯一依据。哪怕只多一个空格、少一个斜杠、大小写错一位,整个调试链路就断了——而 VS Code 不报错,只给你一个空心圆。


















