FastAPI Router Creator 是一个指导创建模块化、有组织的 FastAPI 路由的技能，强调可维护性与可扩展性。
用途 该技能用于指导开发者创建和组织 FastAPI 路由，适用于需要组织复杂 API 结构的场景。它提供两种路由策略的说明，并给出最佳实践建议。
主要能力
- 模块化路由模式（标准）：这是 FastAPI 中最常见且推荐的方式。示例结构为 src/api/v1/endpoints/ 目录下包含 users.py、items.py、auth.py 等文件。每个端点文件通过 from fastapi import APIRouter 创建 router = APIRouter()，并使用 @router.get("/") 等装饰器定义异步处理函数。随后在 src/api/v1/api.py 聚合器中，通过 from src.api.v1.endpoints import users, items 导入，并使用 api_router.include_router(users.router, prefix="/users", tags=["users"]) 等方式将各路由挂载到统一的路由器上。
- 基于文件的路由（fastapi-router）：提供类似 Next.js 的体验，由文件结构决定 URL。需要 fastapi-router 库或自定义遍历器。示例结构为 src/app/api/users/route.py 处理 /api/users，src/app/api/users/[id]/route.py 处理 /api/users/{id}。
使用方式 该技能以指南形式呈现，包含目录结构示例、代码片段和最佳实践说明。开发者可参照示例组织自己的 FastAPI 项目路由。
最佳实践
- 前缀：在路由器 include 层级使用前缀，而不是在每个端点装饰器内部使用。
- 标签：使用 tags 在 OpenAPI 文档中分组端点。
- 依赖：如果依赖（如认证）适用于该路由器中的所有端点，则在路由器层级应用依赖，例如 router = APIRouter(dependencies=[Depends(get_current_active_user)])。
- 版本：按 API 版本（v1、v2）为路由器命名空间。
适用场景 适用于使用 FastAPI 构建 API 并需要组织复杂路由结构的项目，尤其是希望采用模块化或文件驱动路由方式的开发场景。
限制 资料中未提供关于该技能的具体安装命令、收费信息、平台支持范围或实际效果验证等细节，这些内容暂未提供。