FastAPI 应用应通过 APIRouter 合理拆分路由,解决代码复杂度问题。建议目录结构为 app/主文件/dependencies/Router子目录,每个路由文件内部专注业务逻辑。核心要点包括:1. APIRouter 灵活管理路径前缀、文档标签和依赖;2. 中间件、异常处理等公共逻辑归属主文件,路由函数需精简;3. 路由级依赖可整组生效,减少单个接口注解;4. 误区需规避重复路径、过度拆分(粒度以资源为单位)及错误的独立 App 实例创建。重要操作:路由注册时指定前缀(如)/api/v1,依赖注入作用于整个路由组而非单接口。实际开发中通过模块化提升维护性,避免将小型功能拆分子路由,确保功能边界清晰。