断点打在 await 行不停是因调试器采样时机与 v8 任务队列不一致，并非配置错误；需确保 launch.json type 为 "node"、sourcemaps 正确、避免在 promise 构造函数内打断点。
断点打在 await 行却不停，不是配置错，是调试器采样节奏问题
VSCode 默认对 await 的暂停行为有延迟或跳过倾向，尤其在 Promise 状态未完全 settle 前，调试器可能只捕获到中间态。这不是 launch.json 配置错误，而是 V8 执行上下文切换与调试器采样时机不一致导致的。
确保以下三点：
-
launch.json中"type"必须为"node"（不是"node2"或"pwa-node"） - 若用 TypeScript，
"sourceMaps": true且编译后.map文件路径与源码匹配；TS 项目建议加"outFiles": ["./dist/**/*.js"]并确认无路径别名干扰 - 避免在
new Promise((resolve, reject) => { ... })内部打断点——V8 可能因优化直接跳过，优先打在await语句末尾或 async 函数首行
Promise 值显示为 Pending 或 undefined，该看哪里
Variables 面板默认只展示同步快照，不会主动等待 Promise resolve。这不是变量没赋值，而是调试器还没“看到”结果。
正确做法：
- 在 Debug Console 中直接输入变量名（如
result）并回车，强制触发其then回调并输出 resolved 值 - 右键 Variables 面板中的 Promise 对象 → “Re-evaluate”，刷新当前状态
- 检查是否漏了
await：比如写了fetch('/api')没await，那result类型确实是Promise，不是 bug
Promise.reject() 后进程崩溃，但断点不触发
VSCode 调试器把同步异常和未处理拒绝（unhandled rejection）视为两类独立事件。“Uncaught Exceptions” 断点开关对 Promise.reject() 完全无效。
必须手动启用：
- 打开「运行和调试」面板 → 「断点」区域 → 点击
+号 → 选择Node.js: Uncaught Promise Rejections - 确认该断点图标为实心（非灰色空心），且仅在 F5 启动调试模式下生效
- 删掉
launch.json里所有"exceptions"字段——它对 Promise 拒绝毫无作用
异步 CLI 工具（yargs/commander）中 handler 不进断点
yargs 的异步 handler 不触发，通常是因为 Node.js 的 argv 传递链路被 VSCode 截断，或 Promise 链调度让断点“失焦”。
关键操作：
- 在
launch.json的"args"字段里明确传参，例如["init", "--force"]，不要依赖默认process.argv - 把断点打在
await行右侧（分号前），而非async function handler()函数签名行 - 将
"node_modules/yargs/**"加入skipFiles，避免陷进内部 task_queues 调度逻辑
真正卡住人的从来不是“怎么设断点”，而是 Promise 状态、调试器采样、V8 任务队列三者之间的时序差。与其反复重启调试会话，不如养成在 Debug Console 主动求值的习惯——await result 一句，比十次 F10 更可靠。
