什么是 FastAPI
在 Python Web 开发领域,FastAPI 因其高性能和易用性逐渐成为首选。相比 Django 的厚重和 Flask 的灵活但需手动配置,FastAPI 结合了类型提示带来的自动验证与文档生成能力,让接口开发更加高效。
对于新手而言,FastAPI 的优势在于无需编写额外文档代码即可自动生成 Swagger UI 界面,且利用 Python 的类型注解能在运行时捕获参数错误,减少线上 Bug。
环境搭建
确保已安装 Python 3.8 及以上版本。首先安装 FastAPI 框架及 ASGI 服务器 Uvicorn。
pip install fastapi uvicorn
国内用户若遇到下载慢,可指定镜像源:
pip install fastapi uvicorn -i https://mirrors.aliyun.com/pypi/simple/
启动服务
新建 main.py 文件,编写基础应用代码。
from fastapi import FastAPI
import uvicorn
app = FastAPI()
@app.get("/")
def root():
return {"message": "Hello World"}
if __name__ == "__main__":
uvicorn.run(app="main:app", host="127.0.0.1", port=8000)
这里的 main:app 表示运行 main.py 中的 app 对象。启动后访问 http://127.0.0.1:8000,即可看到返回的 JSON 数据。
此外,也可以在终端直接通过命令启动:
uvicorn main:app
自动生成的文档
FastAPI 最实用的功能之一是自动文档。启动服务后,访问 /docs 路径(即 http://127.0.0.1:8000/docs),系统会自动渲染出 Swagger UI 界面。
在这里可以直接查看接口定义,点击 Try it out 按钮填写参数并执行测试,无需借助 Postman 等外部工具,极大提升了调试效率。
接收请求数据
后端开发的核心流程是接收数据、处理并返回结果。FastAPI 主要通过两种参数方式处理请求。
路径参数
当 URL 中包含动态部分时,例如查询 ID 为 5 的学生信息,URL 通常为 /student/5。
from fastapi import FastAPI
import uvicorn
app = FastAPI()
():
{
: student_id,
: ((student_id))
}
__name__ == :
uvicorn.run(app=, host=, port=)


