“按业务领域组织 FastAPI 代码，比按 routers/models/schemas 这种文件类型拆分更适合中大型项目。”

“FastAPI 快不快，关键不在于你写没写 async，而在于有没有把阻塞操作放错地方。”

“Pydantic 最有价值的地方不是省几行校验代码，而是帮你把请求、响应、配置和内部数据边界理顺。”

“FastAPI 的依赖项不只是注入数据库会话。把资源校验、权限检查和 REST 路径命名统一起来，路由会轻很多。”

“FastAPI 自带文档能力，但默认生成的文档远不够"规范"。从请求参数的描述和示例，到 response_model 的正确用法，再到 responses 补全错误契约，这篇讲怎么把接口文档做到前后端都能直接用。”

“随手 raise HTTPException 能跑，但扩大后很快失控。这篇讲如何通过错误分类、分层边界和全局 handler，让错误处理变成可维护的系统。”

“FastAPI 项目的数据库体验，很大程度上取决于迁移是否可读、命名是否一致，以及你有没有把该放进 SQL 的工作继续留在 Python 里做。”

“测试写不好，不是因为不够勤快，而是因为没有策略。这篇讲 FastAPI 项目里如何分层测试、搭建可靠的异步测试基础设施，以及 Ruff 怎么帮你在写代码时就发现问题。”