swagger 文档优化 knife4j 增强 Swagger

swagger 省去了程序员开发过程中拟写接口文档的时间，是团队开发必不可少的工具，原生的swagger 界面功能比较少，也不支持文档导出，业界也有不少针对swagger 文档界面优化的插件，良莠不齐，选一个功能比较强大的推荐一下： knife4j
官网地址：https://doc.xiaominfo.com/knife4j/documentation/

项目里增加maven 引用

  <dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>knife4j-spring-boot-starter</artifactId>
            <version>3.0.2</version>
        </dependency>

启动后查看

Swagger 原生提供的界面使用体验比较差。常用的增强 Swagger 的方案有下面两种：

YApi ：YApi 是一个可本地部署的、打通前后端及 QA 的、可视化的接口管理平台。可以帮助我们让 swagger 页面的体验更加友好，目前很多大公司都在使用这个开源工具。项目地址：https://github.com/YMFE/yapi 。使用方法：当 Swagger 遇上 YApi，瞬间高大上了！

Knife4j ：Swagger 生成 Api 文档的增强解决方案，前身是 swagger-bootstrap-ui 。官方文档：https://xiaoym.gitee.io/knife4j/documentation/ 。

根据官网介绍，knife4j 是为 Java MVC 框架集成 Swagger 生成 Api 文档的增强解决方案。

项目地址：https://gitee.com/xiaoym/knife4j 。