vs code原生调试器不显示协程生命周期，需借助vscode-debug-visualizer插件可视化task状态、挂起点及异常；调试时应使用asyncio.create_task()创建可追踪的task而非裸协程。
VS Code 调试器原生不显示协程生命周期，别指望断点暂停就能看到 await 堆栈
VS Code 内置的 Python 调试器（基于 debugpy）对协程的支持停留在“能停、能看变量、能单步”的基础层。它不会把 async def 函数调用渲染成独立的“协程帧”，也不会在 Call Stack 面板里展开 await 链——你看到的仍是普通函数调用栈，协程对象（coroutine object）只作为变量存在，状态（如 pending、running、done）藏在 cr_state 属性里，不点开根本看不到。
这意味着：你在 await asyncio.sleep(1) 处设断点，调试器会停；但你想知道“当前这个协程是不是被挂起”“它挂在哪一行”“谁在等它”，光靠默认面板做不到。
- 协程不是线程，
Call Stack不反映事件循环调度逻辑 -
Variables面板里coro变量默认只显示<coroutine object ... at></coroutine>，不展开看不到cr_await或cr_frame - 单步执行（
F11）进入await表达式时，实际跳转的是事件循环内部，不是你的源码行
vscode-debug-visualizer 是目前唯一能直观展示协程状态的插件
它不依赖 debugpy 的底层协议扩展，而是通过在调试控制台中注入运行时检查逻辑，把协程对象解析成可读结构。安装后，在断点暂停时，右键变量 → “Debug Visualizer: Show” 或运行命令 Debug Visualizer: New View，输入 coro 或 task，就能看到：
- 协程当前状态（
pending/running/done） - 挂起点源码位置（
cr_frame.f_lineno和文件路径） - 如果已
done，显示返回值或异常 traceback - 如果是
Task对象，额外显示其所属事件循环、是否被 cancel
注意：vscode-debug-visualizer 默认只支持 Python 3.8+，且需确保协程对象未被垃圾回收（即变量仍被引用）。若你在 asyncio.create_task() 后立刻丢弃引用，可视化面板会显示 None 或报错 RuntimeError: coroutine is not running。
调试协程时必须配合 task 对象，而不是裸协程
直接 await coro() 创建的协程对象生命周期极短，调试器抓取窗口窄；真正可观察、可中断、可管理的单元是 asyncio.Task。所以可视化调试前，先重构关键协程为 task：
- 用
task = asyncio.create_task(my_coro())替代await my_coro() - 在断点处检查
task变量，而非my_coro()返回值 - 在调试控制台执行
task.get_coro()可获取底层协程用于深度查看 - 调用
task.cancel()后，可视化面板会实时更新状态为cancelled，比 print 日志快得多
常见坑：asyncio.ensure_future() 返回的也是 Task，但若传入的是已 await 完的协程（比如 ensure_future(await coro())），结果是 Future 而非 Task，无法被该插件识别。
协程调试失败的典型错误信息及应对
遇到这些提示，基本可以判定是协程生命周期或插件配置问题：
-
Cannot visualize: object has no attribute 'cr_state'→ 传入的不是协程对象，可能是None或普通函数返回值 -
RuntimeError: cannot reuse already awaited coroutine→ 在调试控制台重复执行了await coro，协程已耗尽 - 可视化面板空白或显示
undefined→ 插件未激活调试会话，确认已按F5启动调试（非直接运行），且断点已命中 -
AttributeError: 'Task' object has no attribute 'cr_state'→ 正确现象，Task用_state和_coro，插件内部已适配，不用手动访问
协程调试的关键不在“看到更多”，而在“看到准确的状态归属”。一个 pending 的 task 挂在 await asyncio.sleep() 上，和挂在 await aiohttp.get() 上，行为完全不同——插件能帮你区分这两者，但前提是 task 必须存活、变量名必须可追踪。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
