如何在VSCode中配置Python的异步代码调试-VSCode-PHP中文网

vscode python异步调试需设"type": "python"、"justmycode": false，用breakpoint()替代ui断点，uvicorn/fastapi须用module模式启动并禁用热重载。

如何在vscode中配置python的异步代码调试

launch.json 里 type 必须是 "python"，不是 "pwa-python"

VSCode 的 Python 调试器靠 type 字段决定用哪个适配器。异步调试也一样——如果写成 "type": "pwa-python"（旧版遗留）或误填为 "node"，断点会静默失效，控制台不报错，但程序一路跑完。

验证方式很简单：启动调试时看左下角状态栏是否显示 “Python Debugging”；或者在代码行号左侧点击，出现实心红点且悬停提示 “Breakpoint set”，才算识别成功。

不要从 Node.js 或其他语言项目复制 launch.json 后直接改名了事
确保只启用官方 ms-python.python 扩展，禁用冲突的第三方 Python 插件
工作区根目录下只能有一个有效的 .vscode/launch.json，多层嵌套时 VSCode 可能加载错路径下的配置

asyncio 代码必须用 `breakpoint()` 或显式设置断点

VSCode 默认调试器对 await 表达式、async for 循环和事件循环调度的支持有限。单纯在 await some_coro() 行设断点，经常跳过——因为那行本身不执行，只是挂起协程。

更可靠的做法是把断点打在协程函数内部、或在关键逻辑前插入 breakpoint()：

async def fetch_data():
    await asyncio.sleep(1)
    data = {"status": "ok"}
    breakpoint()  # 这里能稳停
    return data

breakpoint() 是 Python 3.7+ 原生调试入口，比 UI 断点更贴近运行时上下文
避免在顶层 asyncio.run() 调用处设断点，它只是启动器，不包含业务逻辑
若用 uvicorn 或 fastapi，需额外配置 "subProcess": true，否则子进程里的异步逻辑无法 attach

多线程 + 异步混合场景要关掉 `justMyCode`

当代码同时用到 threading.Thread 和 asyncio（比如后台线程发 HTTP 请求、主线程 await 结果），默认 "justMyCode": true 会让调试器跳过标准库和第三方包中的协程调度逻辑，导致断点卡在 event loop 外围，进不了实际 handler。

testing-python

使用pytest编写和评估有效的Python测试。适用于编写测试、审查测试代码、调试测试失败或提高测试覆盖率。

下载

把 justMyCode 设为 false，才能看到 asyncio.events、concurrent.futures 等模块里的调用栈：

{
  "name": "Python: Async + Thread",
  "type": "python",
  "request": "launch",
  "module": "main",
  "justMyCode": false,
  "console": "integratedTerminal"
}

副作用是变量面板会多出大量标准库变量，需要手动折叠无关作用域
调试结束后建议切回 true，避免日常开发时信息过载
配合 "logToFile": true 查看 debugpy 日志，搜索 "coroutine" 或 "task" 关键词可确认是否真正进入了协程上下文

Uvicorn/FastAPI 调试必须用 `module` 模式而非 `program`

直接运行 main.py 无法触发 FastAPI 的异步生命周期——Uvicorn 是通过 importlib 动态导入 app 实例并注册事件循环的。用 "program": "${file}" 会导致 app 变量未被正确暴露给 Uvicorn 的 loader。

正确做法是用 module 启动模式，并指定 Uvicorn 入口：

{
  "name": "FastAPI: Debug",
  "type": "python",
  "request": "launch",
  "module": "uvicorn",
  "args": [
    "main:app",
    "--host", "127.0.0.1",
    "--port", "8000",
    "--reload=false"
  ],
  "console": "integratedTerminal"
}