Python搭建FastAPI简单Web项目教程

本文深入浅出地讲解了如何用FastAPI搭建结构清晰、启动迅速且易于扩展的轻量级Web应用，强调“够用不臃肿”的实用主义原则：以main.py为纯净入口仅负责启动和路由注册；通过api/目录按版本与功能模块化组织接口；严格分离schemas/（Pydantic校验模型）与models/（ORM实体）实现关注点隔离；并借助config.py和deps.py统一管理配置与依赖注入。整套结构专为个人项目或快速验证想法而设计，拒绝过度工程化，倡导从/hello起步、渐进式演进，让开发者专注业务逻辑而非框架陷阱。

用 FastAPI 搭建简单 Web 应用，关键不是堆功能，而是结构清晰、启动快、后续好扩展。下面直接说一个够用又不臃肿的项目结构，适合个人小项目或快速验证想法。

核心文件：main.py 是入口

整个应用从这里启动，只放路由注册和应用实例创建，不写业务逻辑。

• 用 FastAPI() 创建 app 实例
• 用 @app.get("/") 这类装饰器挂接口，但只做转发（比如调用 api/v1/items.py 里的函数）
• 加一句 uvicorn.run("main:app", reload=True) 方便本地调试

按模块拆路由：api/ 目录分版本和功能

把接口按业务或资源归类，避免所有路由挤在 main.py 里。

• 例如：api/v1/items.py 处理商品相关接口，api/v1/users.py 处理用户相关
• 每个文件里用 APIRouter() 定义子路由，再在 main.py 中 include 进来
• 路径自动带前缀，比如 router = APIRouter(prefix="/items")，那么 @router.get("/list") 对应的就是 /v1/items/list

数据模型和校验：schemas/ 和 models/ 分开

FastAPI 靠 Pydantic 做请求/响应校验，建议把定义收在 schemas/；如果用 ORM（如 SQLAlchemy），实体类放 models/。

• schemas/item.py：定义输入（ItemCreate）、输出（ItemOut）、更新（ItemUpdate）等 Pydantic 模型
• models/item.py：对应数据库表的 ORM 类（字段可和 schema 不完全一致，比如加 id、created_at）
• 接口函数里接收 schema 类型参数，内部转成 model 存库，返回时再转回 schema —— 清晰隔离关注点

配置和依赖：config.py + deps.py 统一管理

数据库连接、密钥、环境变量这些别散落在各处。

• config.py：用 pydantic.BaseSettings 读取 .env 或环境变量，统一提供配置对象
• deps.py：放 Depends() 用的函数，比如 get_db() 获取数据库会话，get_current_user() 做认证
• 接口里直接写 db: Session = Depends(get_db)，不用每次手动初始化

基本上就这些。不需要一上来就上 Docker、Celery、RBAC —— 先跑通 /hello，再加 /items，再连数据库，结构自然就长出来了。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~