只要一个依赖给Swagger换上新皮肤，帅呆了！

Swagger作为一款非常流行的API文档生成工具，相信很多小伙伴都在用。Swagger最为方便的地方在于，你的项目只要集成了它，一启动就能生成最新版文档，而且可以在线调试。不过Swagger的接口调试功能确实有很多缺点，比如对JSON支持不太友好。今天我们使用Knife4j来增强下它，使用的是SpringDoc提供的Swagger实现库，希望对大家有所帮助！

聊聊Swagger的Java库

首先我们来聊聊Java中两种比较流行的两种Swagger实现库，对比下哪个更好用。

SpringFox

SpringFox是老牌的Swagger实现库，Github上标星5.6K+，相信很多小伙伴项目中都集成的是这个库。不过该实现库在两年前发了3.0.0版本后就再也没发版本了。而且如果你在SpringBoot 2.6.x版本以上使用的话，会发现许多问题需要自行解决，

SpringDoc

SpringDoc是最近才流行起来的Swagger实现库，Github上标星2K+，版本更新还是很快的，维护更新有保障。

SpringDoc的功能还是挺强大的，不仅支持Spring WebMvc项目，还可以支持Spring WebFlux项目。

该选哪个

如果你的项目中已经集成了SpringFox并大量使用了，还是依然使用SpringFox吧，毕竟迁移也是需要成本的。如果你的项目是新项目目前正在技术选型阶段可以考虑使用SpringDoc，毕竟更新维护更有保障。

SpringDoc结合Knife4j使用

Knife4j是一款Swagger UI增强库，之前一直以为它只支持SpringFox，最近发现它也支持了SpringDoc。Knife4j可以无缝支持SpringDoc，仅需添加一个依赖即可，无需修改任何用法，非常方便！

这里我们还是使用[SpringDoc中的mall-tiny-springdocDemo，首先在pom.xml中添加Knife4j相关依赖；

<!--Knife4j的Swagger皮肤依赖-->
<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-springdoc-ui</artifactId>
    <version>3.0.3</version>
</dependency>