VSCode默认不显示完整异步调用链，需手动启用异步堆栈追踪：在launch.json中添加"runtimeArgs": ["--enable-source-maps", "--async-stack-traces"]，或命令行启动时加这两个参数；同时确保sourceMap配置正确且Node.js版本≥12。
VSCode 调试器默认不显示完整异步调用链
你断在 await fetch() 后面却只看到一层堆栈，不是配置错了，而是 Node.js + VSCode 默认关闭异步堆栈追踪。Chrome DevTools 有 “Async” 复选框，但 VSCode 的 Node.js 调试器（基于 Chrome DevTools Protocol）不会自动启用它——必须手动配 traceOptions 或启动参数。
启用异步堆栈需改 launch.json 或启动命令
两种等效方式，任选其一即可：
- 在
.vscode/launch.json的配置中添加："runtimeArgs": ["--enable-source-maps", "--async-stack-traces"]
- 或直接用命令行启动调试进程：
node --enable-source-maps --async-stack-traces --inspect-brk index.js - 注意：仅
--async-stack-traces不够，Node.js 12+ 才支持，且必须配合--enable-source-maps（否则映射失败，堆栈仍为空） - 若用 TypeScript，确保
tsconfig.json中"sourceMap": true已开启，且输出路径与outFiles配置匹配
堆栈里出现 [Async] 标记但点不开源码？检查 sourcemap 映射路径
异步帧能显示，但右键“转到源代码”跳转失败，90% 是 sourcemap 路径解析错误。常见现象：
- 堆栈项显示
async function foo，但点击后打开的是/path/to/dist/foo.js而非src/foo.ts - Call Stack 面板中帧名带
[webpack:///]或webpack://前缀，说明构建工具注入了虚拟路径 - 解决办法：在
launch.json中显式设置"resolveSourceMapLocations"，例如："resolveSourceMapLocations": ["${workspaceFolder}/src/**", "${workspaceFolder}/node_modules/**"] - Webpack 用户确认
devtool设为"source-map"或"inline-source-map"，禁用"eval"类型
Promise.then() 堆栈断裂？别依赖 .then 回调设断点
.then() 回调里的断点无法还原上层调用者，这是 Promise 规范决定的——它天然切断同步堆栈。真正有效的做法是：
立即学习“Java免费学习笔记（深入）”；
- 把
await当作“堆栈锚点”：在await行设断点，VSCode 会沿异步链向上还原（前提是已启用--async-stack-traces） - 避免在
promise.then(() => { /* 断点在此 */ })里设断点；改用async/await重写逻辑，或用console.trace()辅助定位 - 第三方库（如 axios、React Query）内部 Promise 链更长，此时启用
"justMyCode": false可看到框架内帧，但堆栈可能变杂乱——按需开关
异步堆栈不是“开个开关就全好”，它依赖 Node.js 版本、sourcemap 构建质量、VSCode 调试协议版本三者协同。最常被忽略的是：你以为启用了 --async-stack-traces，但实际运行的是没加该参数的普通 node index.js 进程——务必确认调试器启动时确实在用带参数的命令。
