VSCode调试async函数需关闭"justMyCode": false、启用异步堆栈追踪、用Debug Console求值、优先使用breakpoint()。根本原因是调试器默认过滤协程调度逻辑，需手动配置以正确显示变量、堆栈和断点行为。
VSCode 调试 async 函数时断点“跳过”、变量显示为 pending、堆栈不完整——根本不是代码写错了，而是调试器默认绕过了 asyncio 内部调度逻辑。
为什么 await 后断点不触发？justMyCode 必须关掉
VSCode 默认开启 "justMyCode": true，它会过滤掉所有非用户代码的帧，包括 await 暂停后恢复执行的关键调度点（如 asyncio.run()、loop.run_until_complete() 内部）。结果就是：光标走到 await 行就停，但下一行直接执行完，像断点被忽略。
- 在
.vscode/launch.json的调试配置中，显式添加"justMyCode": false - 如果用的是 VS Code 1.85+，这个选项在 UI 调试工具栏齿轮菜单里也能一键关闭，但建议写进配置文件，避免团队协作时遗漏
- 关掉后，Variables 面板才能看到
coroutine对象的真实状态，而不是<coroutine object ...>这种占位符
async 堆栈不显示？手动打开异步调用链
即使断点命中，调用堆栈（Call Stack）面板默认只显示同步路径，await 之后的协程恢复帧被折叠。你看到的是 runpy._run_module_as_main，而不是你写的 main() → fetch_data() → httpx.get()。
- 调试暂停时，点击调试面板右上角的
⋯（更多操作），选择Toggle All Async Stack Trace - 该开关会把协程挂起/恢复的上下文补全进堆栈，让你看清真正的执行流分支
- 注意：这个开关是会话级的，每次新调试需重新启用；没有对应配置项写进
launch.json，只能手动点
变量值显示为 pending 或空？别信悬停，用 Debug Console 直接求值
鼠标悬停在 await 表达式结果上，常显示 pending ——这不是 bug，是调试器没等到协程完成就抓快照。尤其对 async for 或嵌套 await，悬停几乎无效。
立即学习“Python免费学习笔记（深入）”；
- 断点暂停后，在 Debug Console 输入完整表达式回车，比如
response.json()或len(tasks)，它会真实 await 并返回结果 - 对
asyncio.Task对象，输入task.done()或task.result()（确保已完成）可验证状态 - 避免在 Variables 面板里点开
coroutine展开树——它只会显示内部字段（如_state），不反映业务数据
多协程并发时断点乱跳？优先用 breakpoint() 替代 UI 断点
当多个 async 任务并行（如 asyncio.gather()），UI 断点容易在不同任务间“跳跃”，甚至停在你不预期的协程里，因为调试器按事件循环调度顺序而非代码书写顺序触发。
- 在关键位置插入
breakpoint()（Python 3.7+），它会在当前协程上下文中强制中断，不受其他任务干扰 - 确保
PYTHONASYNCIODEBUG=1环境变量已启用（加到launch.json的"env"字段里），否则breakpoint()可能不生效 - 不要在
__aenter__/__aexit__这类魔法方法里设 UI 断点——它们常被 asyncio 内部调用，justMyCode: false也难保稳定
异步调试真正的复杂点不在设置，而在理解「断点暂停的是当前协程，不是整个事件循环」。你得接受：一个 await 暂停后，其他协程可能还在跑；Variables 面板只反映此刻这个协程的快照，不是全局状态。别指望它像同步代码那样线性展开。
