fastapi接口python后端实战从0开始学习

### 使用 FastAPI 构建 Python 后端接口实战入门 #### 创建项目结构 为了更好地管理代码，在开始编写 API 前建议先规划好项目的目录结构。通常情况下，一个简单的 FastAPI 应用程序可以具有如下基本布局： ``` my_fastapi_app/ │ ├── main.py # 主应用程序入口文件 └── requirements.txt # 依赖包列表 ``` #### 安装 FastAPI 和 Uvicorn 在终端中执行命令来安装必要的库： ```bash pip install "fastapi[all]" pip install uvicorn ``` 这会下载并配置 FastAPI 及其推荐使用的 ASGI 服务器 `uvicorn`。 #### 初始化 FastAPI 应用 编辑 `main.py` 文件，加入以下内容以初始化一个新的 FastAPI 实例[^1]: ```python from fastapi import FastAPI app = FastAPI() @app.get("/") async def read_root(): return {"message": "Hello, World!"} ``` 上述代码片段展示了如何创建一个最基础的 HTTP GET 请求处理器，当访问根路径 (`/`) 时返回 JSON 格式的问候消息。 #### 运行应用 保存更改后，在命令行工具里切换至项目所在文件夹并通过下面这条指令启动服务： ```bash uvicorn main:app --reload ``` 参数说明： - `main`: 表示包含 FastAPI 应用逻辑的 `.py` 文件名（不带扩展） - `app`: 是指代 FastAPI 对象的名字 - `--reload`: 当源码发生变动时自动重启服务器以便即时查看效果 此时打开浏览器前往 http://localhost:8000 即可看到预期的结果；而通过访问 http://localhost:8000/docs 则能够体验到由 Swagger UI 提供的强大交互式文档界面[^3]。 #### 添加更多路由与功能 随着需求的增长，可以在现有基础上继续添加新的 URL 路径映射以及相应的业务处理函数。比如增加 POST 方法用于接收客户端提交的数据： ```python from pydantic import BaseModel class Item(BaseModel): name: str description: str | None = None price: float tax: float | None = None @app.post("/items/") async def create_item(item: Item): item_dict = item.dict() if item.tax: price_with_tax = item.price + item.tax item_dict.update({"price_with_tax": price_with_tax}) return item_dict ``` 这段代码实现了对商品信息对象的支持，并允许用户经由 `/items/` 地址上传新条目。同时利用 Pydantic 模型验证输入字段的有效性和类型一致性。