一、FastAPI 简介
在 Python Web 开发领域，FastAPI 是一款新兴的高性能框架。相比 Django 和 Flask，FastAPI 具有代码简洁、自动生成文档（Swagger UI）以及利用类型提示进行参数校验等优势。
主要特点：
- 自动文档：无需编写额外代码，接口文档自动生成。
- 减少 Bug：基于 Python 类型提示，参数错误会在启动或请求时直接报错。
- 简单易用：Hello World 示例仅需少量代码。
二、环境搭建
1. 安装
FastAPI 依赖 Python 3.8 及以上版本。首先安装 FastAPI 模块：
pip install fastapi -i https://mirrors.aliyun.com/pypi/simple/
其次需要安装 ASGI 服务器，生产环境推荐使用 Uvicorn：
pip install "uvicorn[standard]" -i https://mirrors.aliyun.com/pypi/simple/
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 对象。
启动服务有两种方式：
- 代码内启动：直接运行上述脚本。
- 命令行启动：在终端输入
uvicorn main:app。
启动后访问 http://127.0.0.1:8000，将返回 JSON 数据 {"message": "Hello World"}。
三、自动文档
FastAPI 最显著的功能是自动生成 API 文档。启动服务后，访问 /docs 即可看到 Swagger UI 界面。开发者可以直接在网页上点击 Try it out 填写参数并执行接口测试，无需使用 Postman 等外部工具。
