断点未生效主因是设在不可执行行（空行、注释、声明行）或sourceMaps未启用；需验证红点悬停提示、条件触发变色、状态栏显示“Paused”；异步断点应设在await后或.then内部。

断点设在不可执行行上，VSCode 就不会停——这不是调试器坏了，是它根本没机会触发。

为什么断点点了却不停在你想停的地方

常见错误现象是：点击行号左侧出现红点，但 F5 启动后程序直接跑完，断点没生效。最常被忽略的原因是断点位置本身不可执行。

• 空行、纯注释行、import 或 def / function 声明行（不带逻辑）无法中断，VSCode 会显示为空心红点或灰色点
• TypeScript/JavaScript 项目未开启 sourceMaps: true，断点实际绑定到了编译后代码，导致“漂移”
• Python 中 justMyCode 默认为 true，断点设在 requests.get() 内部等第三方库代码里，调试器直接跳过
• 文件未保存，或调试启动时加载的是旧版本缓存（尤其 Webpack/Vite 热更新中）

怎么确认断点真的“活”了

红色实心圆点 ≠ 断点已就绪。必须验证它是否被调试器成功绑定到可执行语句。

• 鼠标悬停在红点上，若显示 “Breakpoint ignored because generated code not found” 或类似提示，说明 sourceMaps 缺失或路径错
• 右键断点 → Edit Breakpoint → 输入任意条件（如 true），回车后若变橙色，说明绑定成功；仍为红色但无反应，大概率位置无效
• 启动调试后，观察调试工具栏顶部状态栏：如果显示 “Paused on breakpoint”，才表示真停住了；只显示 “Running” 说明断点没命中
• 对 Python，检查 launch.json 中是否显式设了 "justMyCode": false（需调试库源码时）

用好条件断点避免手动跳过

在循环、事件回调、高频函数入口设断点，不加条件等于自找麻烦——你得按几十次 F5 才等到关键那次调用。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 右键行号区 → Add Conditional Breakpoint，输入表达式，如 i === 99、user.id === "abc123"、response.status !== 200
• 日志点（Log Point）本质是无中断断点：右键 → Add Log Point，填入 "req: {req.url}, status: {res.statusCode}"，比插 console.log 干净得多
• 命中计数断点适合排查“第 N 次才出错”的场景：右键 → Edit Breakpoint → 切换到 Hit Count 类型，选 “Hit count is equal to” 并填 100
• 注意：条件表达式语法取决于调试器后端——Node.js 用 JS 表达式，Python 用 Python 表达式，PHP 用 PHP 表达式，不能混用

异步代码里断点容易误判执行流

F10 按下后程序“看似没动”，不是卡死，是你没理解 await 和 Promise.then 的暂停语义。

• 在 await fetch('/api') 行按 F10，调试器只发请求并挂起，立刻跳到下一行——响应还没回来，所以后续读取 data 的断点可能看到 undefined
• 想停在响应处理逻辑里，断点必须设在 .then() 回调内部、async 函数中 await 后的语句，或 try/catch 块内
• Promise 链中每个 .then() 是独立执行上下文，F11 进入的不是外层函数，而是当前 .then() 的回调函数体
• Chrome DevTools 兼容性更好，VSCode 调试 Node.js 时建议在 launch.json 中启用 "resolveSourceMapLocations": ["${workspaceFolder}/**","!**/node_modules/**"] 提升异步栈还原准确率

真正难的不是设断点，是判断该在哪设、设了之后它是否真能反映你关心的那一刻——尤其是变量刚被赋值、异步回调刚进入、或作用域刚切换的那毫秒级窗口。别依赖“看起来停住了”，要看变量面板里值是不是你预期的，再反推断点位置对不对。