前言
FastAPI 是 Python 领域中一款高性能的 Web 框架。相比 Django 的厚重和 Flask 的灵活,FastAPI 在性能、自动文档生成及类型检查方面表现优异。
一、FastAPI 简介
在 Python Web 开发中,FastAPI 因其速度和对现代 Python 特性的支持而受到青睐。它基于 Starlette 和 Pydantic,能够自动生成交互式 API 文档。
二、环境搭建
1. 安装
确保使用 Python 3.8 及以上版本。安装 FastAPI 模块:
pip install fastapi
生产环境推荐使用 ASGI 服务器 Uvicorn:
pip install uvicorn[standard]
2. 运行与启动
新建 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 数据。
三、自动文档生成
FastAPI 会自动根据代码生成 Swagger UI 文档。启动服务后,访问 /docs 即可查看。无需额外编写文档代码,直接在网页上点击 Try it out 即可测试接口。
四、数据接收方式
后端主要工作是接收数据、处理并返回结果。FastAPI 支持多种参数传递方式。
1. 路径参数
用于 URL 路径中的动态部分,例如查询特定 ID 的资源。
@app.get("/student/{student_id}")
def get_student(student_id: int):
return {"学生 ID": student_id, : ((student_id))}


