swagger-ui, redoc 好像都快弃坑了， rapi 作者似乎却干劲十足， openapi-ui 作者躺平式更新，大家现在都在用什么 api 文档软件，经济下行，开源弃坑的好像越来越多？

这里主要是说一些开源免费的 openapi 规范 UI 文档, 那些一上来就无脑各种喷的还请嘴上留情，好歹也算为爱发电，大家都不容易，找点杂事干着也是挺好的

不得不说 apifox 确实是个好东西，目前来看也没咋收费，可是它好像只对 java kotlin 友好，而且我总感觉它好卡，它很多强大的功能我都没有使用过，关键是它为啥必须手动导出 openapi.json 啊，这让想直接根据配置生成 ts http 客户端的前端小伙伴非常蛋疼

目前来看这 4 个包的更新情况：

[swagger-ui]( https://github.com/swagger-api/swagger-ui)：功能完善，没咋更新了，就是 UI 体验很差

[redoc]( https://github.com/Redocly/redoc): 没咋更新了，它竟然不支持测试接口，有点费解

[rapi]( https://github.com/rapi-doc/RapiDoc): 作者重新回归，更新活跃，总感觉它的代码阅读起来费劲，不知道是不是我太菜了

[openapi-ui]( https://github.com/rookie-luochao/openapi-ui): UI 使用良好，使用的最新技术栈构建，代码可读性可维护性高，作者一直在躺平式更新，因为用户太少，没人提 bug😂

xFrye · 2024-10-12 10:07:33

跟经济下行无关，行情好的时候也有不少这样的弃坑项目。多半是作者心思已经不在这项目上了吧

raphaelsoul · 2024-10-12 10:10:12

swagger 看上去很美好但是已经复杂到我不想用的程度了各类语言框架的支持也不完善

concernedz · 2024-10-12 10:10:15

还在用着 yapi ，蛮多 bug 的，但找不到替代品

joyhub2140 · 2024-10-12 10:11:57

用 springdoc 吧，虽然仅仅套个 swagger-ui ，但内部实现还是紧跟 springboot 的节奏的。

dingyaguang117 · 2024-10-12 10:18:53

这个也还行
https://github.com/stoplightio/elements

sss15 · 2024-10-12 10:27:38

现在用 apifox ，目前使用体感还好，没有用到付费的服务

securityCoding · 2024-10-12 10:35:40

最好的 api 文档莫过于 protobuf

lizhien · 2024-10-12 10:40:50

Scalar

wu67 · 2024-10-12 11:25:59

个人觉得, 最好的 api 是特么的把后端的项目 git 权限给劳资打开,
现代后端项目全特么有 mvc 分层了, 详细业务逻辑我看不懂而已, 控制器定义逻辑和参数表我看得懂呀...