api文档工具

优秀的框架都有一个特点：文档和示例非常多，为了方便前后端对接，经常需要自己为代码写注释，为了解放繁琐且易出错的手写API文档，本文总结一下使用过的文档生成工具。
1、 Swagger
生成的接口文档可以直接在线测试，省去了使用 Postman 设置接口参数的过程，而且请求参数，返回参数一目了然。只是需要提前写大量的注解，加上复杂模块的弱势导致我没有继续用。

2、 Eolinker
围绕文档进行工作的模式，一开始只是尝试区别于先开发再写文档，没想到意外的好用，效率提升了不少，还能直接导入Swagger的Json文件，降低了转用的成本。
我现在一直在用的就是这个，后面还发现这是个集成性的工具，其他功能也挺好用的，这里就不展开了。

3、 Apizza
开发时调试接口后，文档就可以同步生成。很方便，就是BUG有点多…

4、 JApiDocs
一个开源的 SpringBoot API 文档生成工具，无需额外注解，厌烦了 Swagger 满屏的注解和额外的工作量可以试一试，我是因为配置麻烦放弃掉了。

希望大家都能找到自己觉得好用的文档生成工具。