VSCode单步调试需满足断点命中、调试器就绪、代码可映射三条件;launch.json必须位于.vscode/目录下且配置正确,sourceMap、outFiles等须匹配源码与产物路径,断点仅在行号区生效,F10/F11依赖运行时模型与符号信息。

VSCode单步调试不是“按F11就能一行行进函数”,而是取决于断点是否命中、调试器是否就绪、代码是否可映射——没配好 launch.json 或源码没生成调试符号,F10/F11 按了也像没按。
F5 启动调试前必须确认 launch.json 存在且有效
按 F5 没反应或弹出“请配置 launch.json”,不是快捷键坏了,是 VSCode 根本不知道怎么跑你的代码。它需要明确的启动指令:
-
launch.json必须放在项目根目录下的.vscode/文件夹里,路径错一个字符(比如写成.VSCode)都不认 - Node.js 项目中
program字段得指向已编译的.js文件(如"./dist/index.js"),不能写"./src/index.ts" - TypeScript 项目若想直接调试源码,必须开启 source map 并在
launch.json中设"sourceMaps": true和"outFiles": ["./dist/**/*.js"] - Python 项目选 “Python File” 配置后,
module字段默认为"python",但若用 Poetry 或 virtualenv,得检查python.defaultInterpreterPath是否指向正确解释器
F9 打断点只响应行号区点击,打错位置完全不生效
断点红点必须出现在编辑器左侧「行号区」的空白处,不是代码行内、不是折叠箭头旁、也不是注释行上——打错位置不会报错,但断点是空心圆,运行时直接跳过:
- 光标停在哪一行不影响 F9 效果,但建议先将光标移到目标行号区再按,避免误打在空行或注释行
- 右键红点 → Edit Breakpoint 可加条件(如
i > 10)或日志表达式(如"user: {user.name}"),比硬塞console.log干净得多 - 断点变空心?90% 是 source map 路径对不上:Node.js 查
outFiles,C++ 查miDebuggerPath,Wasm 查sourceMapPathOverrides
F10 / F11 在异步和内联函数里行为不可靠
F10(Step Over)和 F11(Step Into)不是“字面意义的逐行执行”,它们受运行时模型和符号信息限制:
- F10 遇到
await fetch()会直接跳到下一行,不会停在 resolve 后的回调里;想进回调,得把断点设在async函数内部首行,或直接打在await行本身 - F11 对
std::vector::push_back()或require('express')常跳不过去——前者因编译器内联未生成调试符号,后者因模块没带 source map 或outFiles没配对 - 相比连按 F10,
Shift + F11(Step Out)更稳:从当前函数体立刻返回调用处,适合深嵌套后想快速脱身
调试控制台(Ctrl+Shift+Y)比 hover 更快看到变量值
别依赖鼠标悬停看变量,尤其当对象嵌套深、属性多时,hover 显示不全还容易误触:
- 在调试控制台里直接输入
user.profile.email或Array.isArray(data),回车即得结果,支持完整 JS 表达式 - 终端里跑
curl或node -e "console.log(...)"时,用Ctrl + `切换回来,比反复点标签页快 - 如果调试控制台输出被刷屏,点顶部的垃圾桶图标清空,别手动滚动找上一条
最常被忽略的是:F10/F11 只在调试会话已启动且处于暂停状态时才响应;程序正在运行中按它们,VSCode 完全无反应——这不是快捷键失效,是调试器根本没在监听。


















