VSCode调试Node.js异步代码需规避三大陷阱：await行用F11会跳入V8内部，应断点设在下一行或加条件断点；.then()内联优化致断点失效，须改用命名函数或debugger；必须在launch.json中手动添加"--async-stack-traces"和"--enable-source-maps"并配置"skipFiles"，否则堆栈无法定位业务代码。
VSCode 里调试 Node.js 异步代码，光靠 F5、F10 不够——await 行断点停得早、.then() 里断点常失效、错误堆栈不指向业务代码，这三个问题不解决，调试就卡在“知道出错了，但找不到哪一行”。核心不是记多少快捷键，而是理解每个快捷键在异步上下文里的实际作用时机。
为什么 F11（单步进入）在 await 行会跳进 V8 内部
F11 是逐行进入函数体，但 await fetch('/api') 本质是 Promise 暂停，不是普通函数调用。V8 把 await 编译成 microtask 调度逻辑，F11 会直接跳进 internal/promise 或 async_hooks 等内部模块，全是 runtime 底层代码，和你的业务无关。
- 真正想看
data值？断点打在await下一行，比如console.log(data)，这时变量已赋值 - 想确认
await是否触发？在await行右侧空白处右键 → “Add Conditional Breakpoint”，填!data，只在未赋值时停 - 别依赖 UI 上的“Step Into”按钮——它和
F11行为一致，同样会陷进底层
如何让 .then() 和 .catch() 断点真正生效
直接在 .then(res => { console.log(res); }) 的花括号第一行打红点，大概率不触发。V8 对简单箭头函数做内联优化，断点被忽略。
- 把回调提成命名函数：
promise.then(handleSuccess).catch(handleError)，再在handleSuccess函数首行设断点 - 临时加
debugger：在.then()回调第一行写debugger;，强制中断（仅限本地开发，切勿提交） - 避免链式写法：
fetch().then().then().catch()容易丢失上下文，改用async/await更利于断点控制
--async-stack-traces 必须手动加进 launch.json
VSCode UI 里那个“Enable async stack traces”开关只是控制调用栈面板是否展开异步帧，不影响底层堆栈生成。没加 --async-stack-traces，catch 里看到的堆栈顶永远是 nextTick 或 Promise.then，根本找不到 await api.login() 是哪一行抛的错。
- 必须在
launch.json的runtimeArgs里显式写入："--async-stack-traces" - 配套加
"--enable-source-maps"，否则 TypeScript 或打包后代码无法映射回源码行 - 别漏掉
"skipFiles": ["<node_internals>/**"]</node_internals>，否则调用栈里塞满 V8 内部路径，业务代码被淹没
异步调试真正的复杂点不在操作步骤多，而在于每个断点行为都依赖底层 Promise 实现机制——你看到的“停在哪”，是由 V8 的 microtask 队列调度、内联优化、堆栈追踪开关共同决定的。漏掉 --async-stack-traces 或误用 F11，调试就退化成猜谜。
