FastAPI文档自动生成：Swagger与OpenAPI的使用技巧

FastAPI的自动文档功能基于OpenAPI规范，通过Swagger UI和ReDoc提供交互式接口文档，可快速展示接口功能、参数及返回值，支持直接测试。启用方式简单：创建FastAPI应用，运行后访问`/docs`（Swagger UI）或`/redoc`（ReDoc）即可查看。 核心技巧包括：用`FastAPI`构造函数参数设置全局信息（标题、描述、版本等）；通过函数注释、`Path`/`Query`工具类详细描述接口和参数；用`tags`分类接口便于筛选；通过`include_in_schema=False`隐藏内部接口；使用Pydantic模型规范返回格式，或用`HTTPException`标注错误状态码。 这些方法可提升文档清晰度与易用性，避免手动编写维护的麻烦，确保接口信息与代码一致，优化团队协作与用户体验。