FastAPI

基于 Python 类型注解构建 API 的高性能 Web 框架

开发框架 AI 开发免费开源

访问官网 GitHub 文档

核心功能

FastAPI 用标准 Python 类型注解声明参数与数据结构，自动完成校验、序列化和 OpenAPI 文档生成。适合需要快速交付、并且希望接口文档与代码始终保持一致的后端 API 项目。

功能亮点

类型即校验规则

item_id: int 这样的注解直接生成参数校验和类型转换，不用另写一层校验代码

文档随代码自动更新

接口签名变化后交互式文档同步刷新，官方称其为 standards-based 的 OpenAPI 输出

官方给出的效率数字

内部团队实测开发速度提升约 200%-300%，人为编码错误减少约 40%

一条命令起开发服务

fastapi dev 自动检测应用对象、拉起 Uvicorn，并默认开启本地开发的自动重载

安装档位可选

standard 档带全套可选依赖，也可只装 fastapi 或用 standard-no-fastapi-cloud-cli 精简

适用场景

• 对外提供 REST API 的后端服务，需要一份始终准确的接口文档
• 前后端分离项目的数据接口层，靠类型注解统一请求响应结构
• 把已有 Python 逻辑封装成 HTTP 服务，快速对接其他系统

安装配置

bash

官方推荐用 uv 创建项目并添加依赖：
uv init awesome-project --bare
cd awesome-project
uv add "fastapi[standard]"

如果偏好手动管理虚拟环境，可以改用 pip：
pip install "fastapi[standard]"

安装档位说明：
uv add fastapi                                  # 不带可选的 standard 依赖
uv add "fastapi[standard-no-fastapi-cloud-cli]"  # 带 standard 但不含 fastapi-cloud-cli

使用方法

python

新建 main.py：
from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def read_root():
    return {"Hello": "World"}


@app.get("/items/{item_id}")
def read_item(item_id: int, q: str | None = None):
    return {"item_id": item_id, "q": q}

启动开发服务器：
fastapi dev

用 uv 管理项目时：
uv run fastapi dev

fastapi dev 会自动读取 main.py、检测其中的 FastAPI 应用，并用 Uvicorn 启动，默认开启自动重载。