引言

FastAPI 是一个现代、快速（高性能）的 Web 框架，用于构建 API，由 Python 3.6+ 支持。它基于标准 Python 类型提示，旨在让开发者能够以最少的代码编写出功能强大的 API。本文将为你提供快速掌握 FastAPI 的入门基础知识，包括其安装、基本概念、路由和依赖注入等。

安装 FastAPI

在开始之前，确保你的环境中已经安装了 Python。接下来，你可以使用以下命令来安装 FastAPI：

pip install fastapi uvicorn 

uvicorn 是一个 ASGI 服务器，用于运行 FastAPI 应用。

FastAPI 基本概念

1. 类型提示

FastAPI 的一大特点是其类型提示功能。它允许你使用 Python 类型提示来定义你的数据模型，从而让框架自动生成 Swagger UI 或 ReDoc API 文档。

2. 路由和视图函数

FastAPI 使用路由和视图函数来定义 API 的端点。路由是通过装饰器来定义的，而视图函数则是处理请求的逻辑。

3. 响应模型

在 FastAPI 中，你可以定义响应模型来描述 API 的输出。这有助于提高代码的可读性和可维护性。

快速入门示例

以下是一个简单的 FastAPI 应用示例：

from fastapi import FastAPI, HTTPException app = FastAPI() @app.get("/") async def root(): return {"message": "Hello, world!"} @app.get("/items/{item_id}") async def read_item(item_id: int): if item_id == 404: raise HTTPException(status_code=404, detail="Item not found") return {"item_id": item_id} 

在这个示例中，我们定义了两个端点：根路径 / 和 /items/{item_id}。根路径返回一个包含问候信息的字典，而 /items/{item_id} 端点根据传入的 item_id 返回相应的信息。

路由和视图函数

路由

路由是通过装饰器来定义的，例如 @app.get() 或 @app.post()。以下是一些常用的路由装饰器：

• @app.get()：处理 HTTP GET 请求
• @app.post()：处理 HTTP POST 请求
• @app.put()：处理 HTTP PUT 请求
• @app.delete()：处理 HTTP DELETE 请求

视图函数

视图函数是处理请求逻辑的地方。以下是一个示例：

from fastapi import FastAPI, HTTPException app = FastAPI() @app.get("/items/{item_id}") async def read_item(item_id: int): if item_id == 404: raise HTTPException(status_code=404, detail="Item not found") return {"item_id": item_id} 

在这个示例中，read_item 函数是一个视图函数，它处理 /items/{item_id} 端点的 GET 请求。函数接收一个名为 item_id 的路径参数，并在返回的字典中包含该值。

响应模型

在 FastAPI 中，你可以定义响应模型来描述 API 的输出。以下是一个示例：

from pydantic import BaseModel class Item(BaseModel): id: int name: str description: str = None price: float tax: float = None 

在这个示例中，我们定义了一个名为 Item 的 Pydantic 模型，它包含一个整数 id、一个字符串 name、一个可选的字符串 description、一个浮点数 price 和一个可选的浮点数 tax。

总结

通过本文，你了解了 FastAPI 的基本概念和快速入门示例。FastAPI 是一个功能强大且易于使用的 Web 框架，可以帮助你快速构建 API。希望这篇文章能帮助你快速掌握 FastAPI。