F5、F9、F10、F11、Shift+F11是真正省时30秒以上的核心调试快捷键;F5需launch.json就绪,F9仅在行号区生效,F10/F11受异步与内联限制,Shift+F11跳出更稳定。

F5、F9、F10、F11、Shift+F11 是真正能省下 30 秒以上操作的核心快捷键;其余多数在真实调试中反而打断节奏,不建议优先记忆。
F5 启动调试前必须确认 launch.json 已就绪
按 F5 没反应或弹窗提示“请配置 launch.json”,不是快捷键失效,而是调试上下文缺失:launch.json 必须存在于 .vscode/ 目录下,且 program 字段指向可执行文件(如 ./dist/index.js),不能写错路径或用开发时的源码路径。
- Node.js 项目若已手动运行
node app.js,需加--inspect-brk参数,否则F5会因端口冲突静默失败 - C++ 项目必须先生成
tasks.json编译任务,且launch.json中program指向的是已编译的二进制文件,不是.cpp源文件 - WebAssembly 项目必须使用
compound类型启动,单独 launch Chrome 或 attach Node 都无法识别 Rust/C++ 源码里的断点
F9 打断点只认行号区,打错位置完全不生效
断点必须点击在编辑器左侧「行号区」空白处,不是代码行内、也不是折叠区域——打错位置不会报错,但调试时断点是空心圆,且点击无效:
- 光标停在哪一行不影响
F9效果,但建议先将光标对齐到目标行号区再按,避免误打在注释行或空行 - 右键断点 →
Edit Breakpoint可设置条件(如user.id === 123)或日志(如"req: {req.url}"),比硬编码debugger更干净 - 断点变空心?90% 是 source map 路径没对上:C++ 查
miDebuggerPath和setupCommands,Wasm 查sourceMapPathOverrides,Node.js 查outFiles和sourceMaps: true
F10/F11 在异步和内联函数里行为不可靠
F10(Step Over)和 F11(Step Into)在现代语言中不是“逐行执行”的字面意思,而是受执行模型与符号可见性约束:
-
F10遇到await fetch()会直接跳到下一行,不会停在 resolve 后的回调里;想进,得把断点设在async函数内部首行,或await行本身 -
F11对std::vector::push_back()这类模板实例化函数常直接跳过,因为编译器可能内联或未生成调试符号;对require('express')也无效,除非模块有正确 source map 且outFiles配置匹配 -
Shift+F11(Step Out)比连按F10更稳:从当前函数体立刻返回调用处,尤其适合深嵌套后想快速跳出
launch.json 和 tasks.json 的常见错配点
VSCode 调试不是“按下 F5 就跑”,而是依赖两个配置文件协同工作。错一个,F5 就静默失败,终端无输出、也无报错弹窗:
-
tasks.json中的args必须包含-g(C++)或--source-maps(Node.js),否则断点无法命中 -
launch.json的cwd字段必须与program路径相对应;比如program是./build/main,则cwd应为${workspaceFolder},不能漏掉. - Python 项目若用
debugpy,launch.json中必须指定python字段指向解释器路径,不能依赖系统 PATH —— 尤其在虚拟环境激活状态下容易忽略这点
真正卡住调试的,往往不是快捷键记不住,而是 launch.json 里一个斜杠写反、tasks.json 少了个 -g、或者 source map 路径映射没对齐。这些地方不报错,只让断点变空心、F5 没反应、F11 跳过——最耗时间的,永远是看不见的配置偏差。


















