VSCode断点触发需满足三条件:设断点、启动调试会话、断点命中;条件断点须填布尔表达式且变量在作用域内;命中次数断点支持计数与模运算;日志点可无侵入输出变量值。

VSCode 的“中断”不是靠开关控制的,而是由断点、异常配置和调试会话状态共同决定的——没设断点、没启动调试、或断点没命中,它就不会停。
断点不触发:先确认调试是否真正启动
很多人点了F5却没反应,其实是调试会话根本没跑起来。VSCode 不会自动把普通运行变成调试,必须显式进入调试模式。
- 检查左下角状态栏是否显示「正在调试」及环境名(如
Python、Node.js),没有就说明没连上运行时 - 确保已按下
F5或点击「运行和调试」面板中的绿色三角形按钮,而不是只按Ctrl+F5(那是重新启动)或终端里直接执行脚本 - Python 项目中,如果用
python script.py在终端运行,断点完全无效;必须通过 VSCode 的 Python 调试器启动 - JavaScript/TypeScript 项目若用了 Webpack/Vite,需确认构建时启用了
sourceMap,且launch.json中设置了"sourceMaps": true
条件断点写法:表达式必须返回布尔值且变量在作用域内
右键断点选「编辑断点」后填的不是语句,是求值表达式。填错会导致断点变灰(未激活)或静默失效。
- 合法写法:
i === 5、user?.id === "abc123"、response.status >= 400 - 非法写法:
console.log(i)(有副作用,且不返回布尔值)、let x = i + 1(语法错误)、i == "5"(类型不安全,可能漏判) - 注意作用域:循环内定义的
let i在每次迭代都是新绑定,但var i会提升,条件中访问可能取到意外值 - 避免在条件中调用函数(如
fetchUser()),既影响性能,也可能改变程序状态
命中次数断点:适用于高频调用场景的精准暂停
这不是“第 N 次才停”的简单计数器,而是调试器对同一行代码执行次数的累计统计,适合定位循环后期或函数多次调用后的状态漂移。
- 右键断点 →「编辑断点」→ 直接输入数字,如
10表示第 10 次命中该行时暂停 - 支持语法:
>=10(第 10 次及以后都停)、%5==0(每 5 次停一次),但需调试器版本 ≥ 1.85 - 注意:该计数是全局的,跨函数、跨线程不重置;若该行在多个分支中都存在,计数会合并累加
- 与条件断点互斥:同一断点只能设一种类型,改类型前必须清空原设置
日志点(Logpoint):替代 console.log 的无侵入跟踪方式
它不中断执行,只向 Debug Console 输出内容,本质是调试器注入的 console.log 替代方案,但更轻量、可随时开关。
- 右键断点 →「添加日志点」→ 输入模板字符串,如
"i: {i}, arr[i]: {arr[i]}",大括号内为变量名或表达式 - 输出效果等价于在该行插入
console.log("i:", i, "arr[i]:", arr[i]),但不修改源码、不污染 Git - 支持简单表达式:
{user.name?.toUpperCase()}可用,但{api.fetch()}不推荐(仍可能引发副作用) - 在 Node.js 环境中,日志点底层调用的是
console.log,不会触发debugger;语句
最常被忽略的一点是:所有断点行为都依赖当前栈帧的变量快照。异步回调、闭包捕获、编译优化(如 Terser 删除未用变量)都可能导致你看到的值和预期不符——别只信「变量」面板,遇到可疑值,一定切到「调试控制台」手动输一遍变量名再回车验证。











