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😂

[rookie2luochao]

@BiChengfei 用了很多年 swagger, 目前来说没有比它流行的接口规范定义了吧，就是 swagger-ui 设计一直没变过，不太好用，阅读和测试都不是很方便

[rookie2luochao]

@kalman03 指导谈不上，我这就是个 UI ，你这是个对标 apifox 的接口管理平台，体量都不一致，我闲下来学习下

[maguowei]

scalar +1

[kalman03]

@rookie2luochao 如果你忽略根据代码生成 API 的部分，那么它也就是个 UI 。支持标准的 OpenAPI （ swagger ）格式导入，导入后就是一个好看的 UI 接口文档。目前一直是免费的。

[unidotnet]

这种自动化工具是给懒人用的，最主要的还是人工写好文档，看看那些大公司，Facebook ，Salesforce 之类的接口文档，都写的很详细。Postman collection 都是额外的一些 demo 。

[rookie2luochao]

@unidotnet 可是中小公司里面没人愿意写文档，让你抓包的都有，临时甩给你个参数的也有😭😭😭

[rookie2luochao]

@maguowei scalar 其实和我同一时期推出来的，有点尴尬，其实我在推出的 2 年前就写了这个工具的前身，只不过是给公司提供的一个 api 托管平台

[rookie2luochao]

@maguowei scalar 永不收费的话，我也给它投一票

[rookie2luochao]

@coolcoffee 大佬，rapidoc 在接口多了一点之后，和 swagger-ui 一样可阅读性很差啊，它是接口折叠性质的

[Akagi201]

团队在用 apidog (apifox 国际版), 目前遇到问题有导入 openai.json 文件不能正确解析 schema. 其他还好, 也是用了很久, 几乎能满足我一切需求.

[jchnxu]

@rookie2luochao #66 是的。。小公司哪里有大公司那么多资源

[cheng6563]

@raphaelsoul #3 swagger 本身就没做语言框架集成，是要你手写 json 文档的...

[zbowen66]

刚入行写的，虽然也没更新了，但对比官方 UI 还是有信心的 https://github.com/bowencool/swagger-ui

[rookie2luochao]

@zbowen66 刚入行就能写这种东西，还是很优秀了，膜拜大佬😭

[rookie2luochao]

@cheng6563 是的，swagger 只是一个规范，根据代码自动生成 json 文档需要对应语言的实现

[rookie2luochao]

@jchnxu 小公司能将就用个文档软件就不错了，越要后端少写点就少写点，不然他不愿意干

[rookie2luochao]

@Akagi201 apidog 也是 apifox 出品吗？ apifox 优点很多，但是有 2 点让我也感觉很坑，一就是很容易卡，二就是推文档后想拿到接口的 openapi.json 很沙雕，无法自动同步

[zbowen66]

@rookie2luochao #74 当时有大佬指导，可惜很快大佬就跑路了😅

[rockycc]

无脑 yapi 就行。yapi 本身是没有 bug 的，用了 5 年了，好用得不得了，直接替代 postman 进行接口运行和测试。官方 issue 那些都是别人提的需求，不打算实现而已。一个已经做得非常好软件依旧会有人去提 bug ，去提需求，实际体验是完全 okay 的。我的版本是 1.10.2 。

[rockycc]

api 文档管理用已有的 yapi 方案就行，就算有 bug ，也有先行者会替你去修。https://blog.opendeveloper.cn/yapi/bug