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

[rookie2luochao]

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

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

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

swagger-ui：功能完善，没咋更新了，就是 UI 体验很差
redoc: 没咋更新了，它竟然不支持测试接口，有点费解
rapi: 作者重新回归，更新活跃，总感觉它的代码阅读起来费劲，不知道是不是我太菜了
openapi-ui: UI 使用良好，使用的最新技术栈构建，代码可读性可维护性高，作者一直在躺平式更新，因为用户太少，没人提 bug😂

[xFrye]

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

[rookie2luochao]

@xFrye 可是并没有新的接口规范出来，我看作者们 github 好像都没啥更新动态了

[raphaelsoul]

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

[concernedz]

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

[joyhub2140]

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

[rookie2luochao]

@joyhub2140 我们 java 类项目用的 apifox+apifox idea ，对代码侵入还好，后端接受性还不错，不用写很多注解

[dingyaguang117]

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

[rookie2luochao]

@concernedz yapi 不是很早就弃坑了吗，用这个的目前不多了

[rookie2luochao]

@dingyaguang117 这个看着不像接口文档类解决方案啊

[rookie2luochao]

@raphaelsoul 各类语言框架的支持，swagger 官方并没有做啊，都是社区做的

[sss15]

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

[rookie2luochao]

@sss15 后端是 java 的话，用这个玩意确实不错，免费的够用了，但是有一点也还没有找到解决办法，就是 apifox 自动同步 openapi.json

[securityCoding]

最好的 api 文档莫过于 protobuf

[lizhien]

Scalar

[rookie2luochao]

@lizhien 这玩意是往付费运营的

[wu67]

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

[rookie2luochao]

@wu67 后端说：谁特么跟我把数据库权限，sql 权限放开，老子改个表都不行吗？老子改个数据还得写 sql ，还得负责人审批，老子 xxxxxxx00000000

[rookie2luochao]

@securityCoding 这是什么高级玩意，容我看看😊

[SouthRiverMatt]

knife4j 很好用

[rookie2luochao]

@SouthRiverMatt knife4j 应该赶不上 apifox, javaer 说用这个玩意还不错，比 swagger/openapi 舒服，它是自动解析代码的，精确的信息也需要像 swagger/openapi 一样加注解