必须在launch.json的runtimeargs中添加--async-stack-traces，否则调用栈仅显示nexttick或promise.then而无法定位await业务代码行；同时需配合--enable-source-maps确保断点命中，并将断点设在await下一行或使用条件断点查看实际返回值。
按F5启动调试前必须确认launch.json含--async-stack-traces
没加--async-stack-traces就按F5，调用栈里永远只看到nextTick或Promise.then，找不到你写的await fetch('/api')在哪一行——这不是VSCode的问题，是Node.js默认关闭异步堆栈展开。
-
runtimeArgs里漏掉--async-stack-traces，等于放弃Promise链上下文 -
--enable-source-maps必须同时存在，否则TypeScript或打包代码断点不命中 - 别信UI里的“Async stack traces”开关，它不改底层V8行为，只影响部分视图渲染
断点打在await行根本看不到返回值
const data = await fetch(url)这行设断点，VSCode停在microtask入队前，data还是undefined，不是fetch没返回，是你停太早了。
- 想看实际返回值：断点打在下一行，比如
console.log(data) - 不想挪断点：在
await行右侧空白处右键 → “Add Conditional Breakpoint”，填!data - 避免用F11“单步进入”，会跳进
node_modules里一堆internal/函数，噪音极大
Promise.then()里断点经常不触发
直接在.then(res => { /* 这里打断点 */ })首行设点，V8内联优化后大概率跳过——不是断点失效，是代码被编译器重排了。
- 把回调提成命名函数：
promise.then(handleSuccess)，再在handleSuccess第一行设断点 - 临时加
debugger语句（仅开发环境，切勿提交） - 别依赖
skipFiles: ["<node_internals>/**"]</node_internals>过滤，它可能把关键Promise运行时帧也跳过
Call Stack面板为空？先看是不是真暂停了
没命中断点、没按F5进调试模式、或者程序跑完退出了，Call Stack面板就是空的——它不回溯历史，只显示当前暂停点的实时调用链。
- 确保
program字段指向真实可执行文件，比如"${workspaceFolder}/index.js"，不是.ts或.mjs没配loader - ESM项目要加
"runtimeArgs": ["--loader", "ts-node/esm"]，否则直接报错退出，根本到不了断点 - 点堆栈某一行只是跳转源码，变量面板仍显示旧帧；真要看那个帧的
this和局部变量，得右键选“Switch to Frame”
异步调用栈最麻烦的从来不是“怎么设断点”，而是“断点停在哪才真正反映业务逻辑状态”。--async-stack-traces是开关，await下一行是落点，Switch to Frame是透镜——三者缺一不可。
