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😂

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

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

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

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

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

scalar +1

Apifox 啊，好多公司在用，又免费

apideploy.com 我开发的，欢迎指导。

swagger ，各种语言都有对 swagger 规范的实现，很多都是嵌入到项目中，实时生成。
接口信息，本来就是一个轻量级，很成熟的东西，功能做完后，本来没必要更新了

可以试试 Spring Restdocs ( https://spring.io/projects/spring-restdocs)，上手略有门槛，切入点很新颖，优点是接口 mock 测试和接口文档相结合，可以根据接口 mock 测试代码，直接生成接口文档。