抛弃 swagger? 这款零成本的 API 文档生成工具，已支持上传到 Yapi, Rap2, Eolinker 多个平台

[MarioLuo]

Yapi X

造了个轮子，从源码解析标准 Javadoc 文档和 spring 注解生成文档, 上传到 YApi, Rap2, Eolinker, Copy as cURL.

重点！零学习成本，代码即文档，支持多种 API 管理平台

亮点！开箱即用，账户密码登录，易于二次开发

欢迎试用，喜欢的点个星星支持

• IDEA 插件地址: Yapi X
• Github: https://github.com/jetplugins/yapix

[tairan2006]

yapi 已经停止维护了吧

[MarioLuo]

@tairan2006 布吉岛，不过 YApi 还是很好用的

[siteshen]

流水的轮子，铁打的 swagger 。

[MarioLuo]

@siteshen 哈哈哈，以前我也用 swagger, 不过现在回不去了

[MarioLuo]

@siteshen 想想年轻的时候再 Rap2 上手写接口文档，那叫痛苦

[fkdog]

对 swagger 真心喜欢不起来，一打开 swagger 密密麻麻的 annotation 人都要裂开了

[siteshen]

@MarioLuo 世界因轮子而多彩，也因轮子而混乱。我用 swagger 就是不想写文档（自动生成满足能大部分需求），如无必要，不想在单独的文件里写，也不在注释里写。

[cweijan]

有个叫 easy-yapi 的插件就是这个功能了.

[MarioLuo]

@fkdog swagger 主要是标准和生态，各种语言支持还是很完美

[MarioLuo]

@cweijan 是的，easy-yapi 很强大可配置性非常，不过这个插件还是有不同的地方：

[MarioLuo]

@MarioLuo Yapi X 的亮点，1. Java 写的易于二次开发，2.支持 Rap2 和 Eolinker，并支持账户密码登录， 为撒要造轮子主要还是因为 easy-yapi 感觉定制不方便, kotlin 写的

[MarioLuo]

@siteshen 最合适的就是最好的，对比 swagger 主要还是学习成本，代码洁癖问题

[balabalaguguji]

要不再支持一个易文档的 https://easydoc.net
接口文档： https://easydoc.net/s/31322154/uOeIUcm6/0ESJTGoc

[MarioLuo]

@balabalaguguji 暂时没打算，目前会优先适配主流的文档平台和打磨文档生成，可考虑 pr 二次开发相对比较简单

[iseki]

建议支持下 oas 之类的 API 规范，生态多少还有一点，可不敢完全供应商锁定

[dbpe]

写注解 No

写 Java doc yes

[egfegdfr]

有款叫 smart-doc 的挺好用

[MarioLuo]

@iseki 非常好的建议，后续会增加导出 swagger.json， 目前来看各种平台也支持导出 swagger.json， 可以放心使用

[MarioLuo]

@dbpe 正解，而且结合 spring 框架， 比 apidoc 这种完全使用注解生成的强

[MarioLuo]

@egfegdfr 很棒的工具，个人偏向于 IDEA 插件，交互更友好些

[NoUltimate]

可以指定自己搭建的 rap2 吗？

[MarioLuo]

@NoUltimate 可以指定，如果未配置相关账户密码，点击上传时，会自动弹出提示输入相关信息

[NoUltimate]

@MarioLuo 我找到配置的地方了，不过上传报错了 Expected a string but was BEGIN_OBJECT，和我 rap 版本（ 2.3 ）有关系吗，注释只加了类开头和请求开头

[MarioLuo]

@NoUltimate Rap2 最新版本才 2.2.3, 可以用淘宝 rap2 官方的测试下，如果还有问题可以在 issues 上沟通下，控制台会打印完整的堆栈信息，另外可以确认下本机能否正常连接到内网 rap2

[Gunn27]

还是用 ApiCat 吧

[liaoberlin]

如果也能支持解析 swagger 注解或者 javadoc 跟 swagger 注解混用的解析就完美了

[MarioLuo]

@liaoberlin 有支持 swagger， 不过目前还没测试过，下个版本会支持