VSCode调试异步代码断点不命中，因await行不执行逻辑而仅挂起协程；应设断点于协程内部或赋值行，配置需启用justMyCode=false、skipFiles和async-stack-traces等。
VSCode 调试异步代码，断点不命中、跳进底层、堆栈找不到业务行——不是配置漏了，而是调试器行为和异步执行模型没对齐。
await 行设断点为什么经常“跳过”或“跳进 V8/asyncio 内部”
因为 await 本身不执行逻辑，只是挂起协程或调度 microtask；调试器在该行暂停时，变量尚未赋值，且后续调度由运行时底层接管。
- Python：不要在
await fetch_data()这行设 UI 断点，改在协程函数内部（如fetch_data的第一行）或紧接await后的赋值行设断点 - Node.js：F11 在
await行会进入async_hooks.js或internal/promise，应改用 F10（单步跳过）或在下一行加breakpoint()/debugger - 通用技巧：用条件断点，例如在
await行右键 → “Add Conditional Breakpoint”，填!data，只在未就绪时中断
launch.json 中必须显式配的关键项
VSCode 不会自动启用异步调试支持，靠配置项触发底层能力。
- Python：确保
"type": "python"（不是"pwa-python"），并设"justMyCode": false（多线程+asyncio 混合时必开） - Node.js：
"type": "node"，"program"必须指向源码（如${workspaceFolder}/index.js），不能是打包后路径 - 两者都需
"skipFiles": ["<node_internals>/**"]（注意 HTML 实体转义），否则单步时卡死在钩子文件 - Node.js 还要加
"runtimeArgs": ["--async-stack-traces", "--enable-source-maps"]，否则catch里堆栈顶永远是Promise.then
async/await 之外的异步模式怎么打有效断点
Promise 链、RxJS、回调函数等不是语法糖，调试器无法自动关联上下文，得靠结构改造或注入点。
-
.then(res => {...})：箭头函数易被 V8 内联优化导致断点失效；改用命名函数.then(handleSuccess)，再在handleSuccess首行设断点 - RxJS：
pipe(map(...), filter(...))行设断点无效；插入tap(x => console.log(x))，在console.log行中断 - 回调风格（如
fs.readFile）：断点必须打在回调函数体内，不能打在调用行；且确认sourceMaps已启用，否则映射错位
为什么 breakpoint() / debugger 比 UI 断点更可靠
UI 断点依赖调试器对源码行号与实际执行指令的映射，而 breakpoint()（Python 3.7+）和 debugger（JS）是运行时主动触发的中断指令，绕过解析阶段误差。
- Python 中，
breakpoint()会强制进入当前帧，能访问完整局部变量，不受justMyCode或协程调度干扰 - JS 中，
debugger在 V8 引擎中具有最高优先级中断权，即使 sourcemap 加载失败也能停住（但可能显示压缩后代码） - 注意：两者都只在开发环境用；
debugger切勿提交到生产代码，breakpoint()建议配合PYTHONBREAKPOINT=0环境变量做条件启用
真正难的不是找到哪几行要配，而是每次设断点前，得先想清楚：这行代码此刻是否真的在执行？变量是否已就绪？控制流是否已被 runtime 接管？——异步调试的复杂性，全藏在这些“时机判断”里。
