#阅读指南

这套教程面向第一次接触 Python Web 和 FastAPI 的同学。

你不需要先学完所有 Python 语法，但建议至少知道：

如果你是第一次学后端，不用急着理解所有细节。先跟着代码跑起来，再回头看解释会容易很多。

#一、教程使用的写法

本文档按当前 FastAPI 官方教程和 Pydantic v2 文档整理，主要使用这些新写法：

代码示例默认使用 Python 3.10+。如果你刚开始学，建议直接安装 Python 3.11 或更新版本。

#二、学习顺序

建议按这个顺序阅读：

1. 快速入门：知道 FastAPI 是什么，并跑通第一个接口。
2. 请求与响应：学会接收路径参数、查询参数、JSON 请求体，以及返回安全的响应数据。
3. 项目组织：学会拆分路由、复用公共逻辑、管理配置。
4. 常用功能：掌握跨域、中间件、文件上传、生命周期和测试。

#三、文档真实性说明

本文档尽量只写 FastAPI 和 Pydantic 官方文档中稳定、推荐的用法，不写已经过时的 Pydantic v1 写法，例如：

#四、官方资料

• FastAPI 官方教程：https://fastapi.tiangolo.com/tutorial/
• FastAPI CLI：https://fastapi.tiangolo.com/fastapi-cli/
• Pydantic v2 文档：https://docs.pydantic.dev/latest/
• Pydantic Settings：https://docs.pydantic.dev/latest/concepts/pydantic_settings/