VSCode Python调试器对async for断点支持不完整，因无法准确跟踪__anext__()协程帧；应改用显式await agen.__anext__()逐行调试或加await asyncio.sleep(0)辅助暂停。
async for 无法在断点处暂停执行？
VSCode 的 Python 调试器（基于 ptvsd 或 debugpy）对 async for 循环内的暂停支持不完整——断点打在循环体内部，有时会跳过或直接跑完整个异步生成器，根本不停。
这不是你代码写错了，而是调试器对 __anext__() 的协程调度跟踪存在局限：它把每次 await gen.__anext__() 当作一个独立的 await 点，但断点没挂载到实际被调度的协程帧上。
- 临时解法：在
async for循环体内第一行手动加await asyncio.sleep(0)，强制让事件循环 yield 控制权，调试器才有机会捕获暂停点 - 更可靠的做法是改用显式调用
agen.__anext__()+await，每步单独设断点：agen = async_generator_func() try: while True: item = await agen.__anext__() # 断点打在这里 print(item) except StopAsyncIteration: pass - 注意：
__anext__()返回的是协程对象，必须await，直接 print 会看到<coroutine object ...>
为什么 step over / step into 在 async generator 函数定义处失效？
你在 async def my_agenerator(): 这一行下断点，按 F10（step over）或 F11（step into），调试器直接跳过整段函数体，甚至不进第一行。
这是因为 async generator 函数本身只返回一个 async_generator 对象，并不立即执行——它的代码块直到第一次 await __anext__() 才真正进入运行态。断点设在函数定义行，等同于断在“构造器”上，而非“执行入口”。
立即学习“Python免费学习笔记（深入）”；
- 正确做法：断点必须打在首次
await agen.__anext__()或async for开始处（即触发执行的位置） - VSCode 中可右键点击变量
agen→ “Debug: Step Into” 不生效；得手动在await行设断点再单步 - 若使用
pytest+debugpy调试测试用例，确保pytest是以--capture=no启动，否则 stdout 缓冲可能掩盖异步流输出顺序
调试时看到 “StopAsyncIteration not caught” 报错但程序没崩？
这是 debugpy 在捕获异常时的副作用：当异步生成器耗尽，__anext__() 抛出 StopAsyncIteration，CPython 内部会静默吞掉它以结束 async for；但调试器有时会把它当作未处理异常高亮出来，吓人但无害。
- 不必 catch 它——标准
async for语法已内置处理，强行 try/except 反而破坏语义 - 如果真想抑制该提示，在 VSCode 的
launch.json中添加："justMyCode": true, "subProcess": true, "console": "integratedTerminal"
并关闭 “Break on exceptions” 中的StopAsyncIteration类型 - 注意：某些旧版 debugpy（StopAsyncIteration 的异常过滤逻辑有 bug，建议升级到 debugpy >= 1.8.2
如何查看 async generator 当前状态和 pending 协程？
VSCode 调试侧边栏的 “Variables” 面板默认只显示 agen 为 <async_generator object ...>，看不出是否已启动、是否挂起、有没有 pending 的 await。
你需要借助 inspect 模块在调试控制台（Debug Console）中手动探查：
- 输入
import inspect; inspect.getgeneratorstate(agen)—— 返回'GEN_CREATED'、'GEN_SUSPENDED'或'GEN_CLOSED' - 若想看当前挂起的 await 表达式，用
agen.ag_await（CPython 实现细节，非公共 API，仅调试时可用）；若为None表示未挂起，否则是正在等待的协程对象 - 注意：这些属性在不同 Python 版本中略有差异（如
ag_running已弃用），推荐统一用inspect.getcoroutinestate()检查其底层协程状态
异步生成器的调试不是线性流程的简单延伸，它的暂停/恢复依赖事件循环调度时机，而调试器的单步能力又受限于 CPython 的帧对象生命周期。最稳的方式，永远是把“一步 await”拆开，而不是依赖 async for 的黑盒行为。
