FastAPI项目应结构清晰、启动快、易扩展：main.py仅作入口和路由注册；api/按版本和功能拆分路由；schemas/与models/分离校验与ORM模型；config.py和deps.py统一管理配置与依赖。
用 FastAPI 搭建简单 Web 应用，关键不是堆功能，而是结构清晰、启动快、后续好扩展。下面直接说一个够用又不臃肿的项目结构，适合个人小项目或快速验证想法。
整个应用从这里启动，只放路由注册和应用实例创建，不写业务逻辑。
api/v1/items.py 里的函数）把接口按业务或资源归类，避免所有路由挤在 main.py 里。
api/v1/items.py 处理商品相关接口，api/v1/users.py 处理用户相关router = APIRouter(prefix="/items")，那么 @router.get("/list") 对应的就是 /v1/items/list
FastAPI 靠 Pydantic 做请求/响应校验，建议把定义收在 schemas/；如果用 ORM（如 SQLAlchemy），实体类放 models/。
立即学习“Python免费学习笔记（深入）”；
schemas/item.py：定义输入（ItemCreate）、输出（ItemOut）、更新（ItemUpdate）等 Pydantic 模型models/item.py：对应数据库表的 ORM 类（字段可和 schema 不完全一致，比如加 id、created_at）数据库连接、密钥、环境变量这些别散落在各处。
config.py：用 pydantic.BaseSettings 读取 .env 或环境变量，统一提供配置对象deps.py：放 Depends() 用的函数，比如 get_db() 获取数据库会话，get_current_user() 做认证基本上就这些。不需要一上来就上 Docker、Celery、RBAC —— 先跑通 /hello，再加 /items，再连数据库，结构自然就长出来了。
以上就是Python如何搭建简单Web应用_FastAPI项目结构讲解【指导】的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
广告Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
205
收藏
取消收藏
