vscode调试fastapi必须用"module": "uvicorn"、正确配置args如["main:app", "--reload"]、选择项目虚拟环境解释器并安装fastapi[all]、启用"subprocess": true和"justmycode": false，否则断点不触发、重载失效、模块找不到。

VSCode 调试 FastAPI 时断点不触发、改了代码不重载、甚至直接报 ModuleNotFoundError: No module named 'uvicorn'，根本不是 FastAPI 写得不对，而是调试启动方式和环境链断了——module 模式配错、解释器没切对、--reload 和 subProcess 没协同，三者缺一不可。

launch.json 必须用 module: "uvicorn"，不能用 program

用 "program": "main.py" 启动，VSCode 会直接执行脚本，跳过 uvicorn 的 ASGI 生命周期。结果就是：

• async 函数里断点设了也跳过，await 行停不住
• Depends 注入失败，request.state 是 None
• 中间件（比如 CORSMiddleware）压根不生效

正确写法只有一条路："module": "uvicorn"，且 "args" 第一项必须是模块路径+实例名，例如 ["main:app", "--reload"]。漏掉 :app 或写成 ["main.py:app"] 都会报 Application not found。

Python 解释器必须指向项目虚拟环境，且已装 fastapi[all]

VSCode 默认可能用系统 Python 或全局 pip，导致 uvicorn 找不到、python-multipart 缺失（表单解析失败）、uvloop 没启用（性能差一截）。检查三件事：

提示词大师-python版

图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍

下载

• 按 Ctrl+Shift+P → 输入 Python: Select Interpreter → 手动选中 .venv/bin/python（macOS/Linux）或 .venv\Scripts\python.exe（Windows）
• 确认右下角状态栏显示的是该路径，不是 /usr/bin/python 或 C:\Python39\python.exe
• 在集成终端里运行 pip install "fastapi[all]"，别只装 fastapi 或分开装 fastapi + uvicorn；[all] 自动带 uvicorn[standard]，含 httptools 和 uvloop

--reload 生效但断点消失？加 subProcess: true

uvicorn --reload 会 fork 新进程，旧调试会话无法 attach 到子进程，所以保存代码后断点全失效。这不是 bug，是默认行为。解决办法只有一处：

• 在 launch.json 的配置里显式加上 "subProcess": true
• 这个字段只对 "type": "debugpy" 有效（新版 Python 扩展默认就是 debugpy，不用改 type）
• 同时确保 "console": "integratedTerminal"，否则看不到 watching for changes... 日志，误以为没 reload

不加 subProcess: true，--reload 就只是“自动重启”，不是“热重载调试”。

常见错误现象与对应修复点

这些报错基本都指向同一个根源：环境没对齐，而不是代码逻辑问题。

• ImportError: cannot import name 'app' from 'main' → 检查 main.py 顶层是否有 app = FastAPI()，不能是 _app、app_v1 或函数返回值
• command 'uvicorn' not found → 终端没激活虚拟环境，或 pip install 时没在该环境下执行
• 断点只停在路由函数第一行，进不去 Depends 函数 → "justMyCode": false 没设，debugpy 跳过了 fastapi/uvicorn 内部代码
• 调试时端口被占用 → 终端里别再手动跑 uvicorn main:app --reload，VSCode 调试已占着 8000 端口

最易被忽略的其实是 subProcess: true 和 justMyCode: false 这两个布尔值——它们不报错，但会让调试体验退化成“半残废”状态：看着像在跑，实则断点、依赖、重载全掉链子。

大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！