Python FastAPI 入门实战：从环境搭建到核心功能详解

注意函数参数中的类型注解 student_id: int。FastAPI 会自动进行类型转换与校验。如果传入非整数（如 /student/abc），框架会直接返回错误提示，避免运行时崩溃。

2. 查询参数 (Query Parameters)

适用于搜索或筛选场景，例如 ?keyword=python&page=1。在 FastAPI 中，未出现在路径定义中的函数参数默认被视为查询参数。

from fastapi import FastAPI
import uvicorn

app = FastAPI()

@app.get("/search")
def search_data(keyword: str, page: int = 1):
    return {
        "关键词": keyword,
        "页码": page
    }

if __name__ == "__main__":
    uvicorn.run(app="main:app", host="127.0.0.1", port=8088)

访问 /search?keyword=apple 时，page 将使用默认值 1；若指定 page=5，则返回对应值。

五、Pydantic 数据模型

处理复杂请求体（如注册、登录）时，逐个定义参数显得杂乱。FastAPI 内置 Pydantic 库，用于定义数据模型的'形状'。

from fastapi import FastAPI
import uvicorn
from pydantic import BaseModel

class UserInfo(BaseModel):
    username: str
    password: str
    age: int = 18
    is_student: bool = True

app = FastAPI()

@app.post("/register")
def register(user: UserInfo):
    if user.age < 18:
        return {"message": "未成年人禁止注册", "code": 400}
    return {
        "message": "注册成功",
        "用户": user.username,
        "身份": "学生" if user.is_student else "社会人"
    }

if __name__ == "__main__":
    uvicorn.run(app="main:app", host="127.0.0.1", port=8088)

在接口定义中，将参数类型指定为 UserInfo。FastAPI 会自动解析前端传来的 JSON 数据并填充到 user 对象中。你可以直接通过 user.username 访问字段。配合 /docs 页面，可直接测试 POST 请求体。

六、总结

掌握上述内容，便已具备 FastAPI 的基础开发能力。回顾要点：

1. 安装：使用 pip 安装 fastapi 与 uvicorn。
2. 启动：Uvicorn 负责运行 ASGI 应用。
3. 文档：/docs 自动生成 Swagger UI，便于调试。
4. 参数：利用 Python 类型提示约束输入。
5. 模型：使用 BaseModel 处理复杂 POST 数据。

FastAPI 不仅提升了编码速度，更通过类型安全机制保证了代码的健壮性，是构建现代 Python API 的理想工具。