VSCode 调试器对 Python 异步协程 Asyncio 的堆栈追踪-VSCode-PHP中文网

根本原因是协程未被调度执行，而非ide故障；断点设在未await的协程内时，其仅是coroutine object，调试器无法进入；vs code需配置"justmycode": false、"type": "debugpy"及pythonasynciodebug=1才能正确追踪异步堆栈。

vscode 调试器对 python 异步协程 asyncio 的堆栈追踪

为什么 async 函数里断点不命中或堆栈为空

根本原因不是 IDE 有 bug，而是协程对象创建后不 await 就不执行——breakpoint() 被调用时，协程可能还只是个未调度的 coroutine object，调试器根本没机会进入其内部。VS Code 默认只跟踪同步调用链，await 后的帧被过滤掉，Call Stack 面板自然显示为空或只有顶层帧。

在 async def func() 第一行加 breakpoint()，运行后不暂停 → 协程未被 await 或 asyncio.create_task() 提交到事件循环
断点命中但变量全为 None、堆栈里看不到 await 后的函数 → "justMyCode": true（默认）屏蔽了 asyncio 内部调度逻辑
单步跳过（F10）后直接退出，没进异步分支 → 调试器未识别 await 为可停顿点，本质是缺少异步堆栈支持

必须改的 launch.json 配置项

VS Code 的 Python 调试器（debugpy）需要显式打开两个开关，才能把 await、asyncio.run() 等调度行为纳入堆栈追踪范围：

设 "justMyCode": false：否则 asyncio.events、base_events.py 这类调度代码全被过滤，你永远看不到“谁触发了这个 task”
确保 "console": "integratedTerminal" 或 "console": "internalConsole"：用 externalTerminal 会丢失部分异步上下文，导致断点失效
不要手动加 "type": "python"（旧版）→ 必须用 "type": "debugpy"，否则异步堆栈解析能力受限

最小可用配置示例：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python: Current File (async)",
      "type": "debugpy",
      "request": "launch",
      "program": "${file}",
      "console": "integratedTerminal",
      "justMyCode": false,
      "env": {
        "PYTHONASYNCIODEBUG": "1"
      }
    }
  ]
}

PYTHONASYNCIODEBUG=1 能暴露什么

这个环境变量不改变代码行为，但让 asyncio 在运行时主动报出三类静默问题，直接反映在终端输出里，比断点更早发现问题源头：

Galileo python sdk

Galileo AI 平台 Python SDK 完整参考，用于评估、监控和保护 GenAI 应用，适用于构建 Python 应用。

下载

RuntimeWarning: coroutine 'fetch_data' was never awaited → 你调了 async def 函数但漏了 await 或 create_task()
Executing <task pending name="..."></task> 长期卡住 → 某个 await asyncio.sleep(10) 或未响应的 aiohttp.get() 拖住了整个 loop
RuntimeError: Event loop is closed → atexit 里或测试 teardown 阶段还在 await，loop 已 shutdown

它不会让断点变多，但能帮你判断“是不是连协程都没跑起来”，避免在错误的地方浪费时间设断点。

Call Stack 面板里怎么看出 async 调用链

启用上述配置后，Call Stack 不会自动变成“Promise.then”那种浏览器式异步链，但你会看到真实调度路径：

顶层帧通常是 asyncio.run() 或 loop.run_until_complete()
中间帧出现 Task._step、Task.__step、_run_once 等 asyncio 内部函数 → 说明事件循环正在调度
真正你的业务函数名会出现在这些内部帧之后，比如 my_handler → fetch_api → parse_json
如果某层突然断开、只剩 <module></module> 或匿名帧 → 很可能是 await 后接了同步阻塞调用（如 time.sleep()），GIL 卡死了 event loop