这是一个创建于 1768 天前的主题，其中的信息可能已经有所发展或是发生改变。
java 写的 web 服务, 要给前端提供接口文档, 问下大家都是怎么生成的?
现在业内实践用的都是啥?
现在业内实践用的都是啥?
第 1 条附言 2021 年 3 月 10 日
看来主流还是 swagger 和 yapi 啊
俺看了一下, 俺的服务不到 10 个接口, 也很简单
所以, 最终, 俺用的方式是
使用 markdown, 手工
感谢铁子们推荐, 等接口复杂了, 再研究你们的工具
俺看了一下, 俺的服务不到 10 个接口, 也很简单
所以, 最终, 俺用的方式是
使用 markdown, 手工
感谢铁子们推荐, 等接口复杂了, 再研究你们的工具
 | 1 alanhe421 2021 年 3 月 10 日 swagger |
 | 2 sunziren 2021 年 3 月 10 日 用过楼上的，挺好的 |
 | 3 gageshan 2021 年 3 月 10 日  1 |
 | 4 knightdf 2021 年 3 月 10 日 openapi, swagger |
 | 5 wolfie 2021 年 3 月 10 日 md 手写，生成的除了自己很难看，而且涉及到字段改动怎么标注。 |
 | 6 lungank 2021 年 3 月 10 日 swagger |
 | 7 rationa1cuzz 2021 年 3 月 10 日 难道就我一个人手写吗？ |
 | 8 hanssx 2021 年 3 月 10 日 如果 python 的话，fastapi 很不错。 |
 | 9 zlhsvc 2021 年 3 月 10 日 手写，之前用过脚本总觉得差了点 |
 | 10 yiqiao 2021 年 3 月 10 日 swagger 能够快速生成。 showdoc |
 | 11 acmore 2021 年 3 月 10 日 swagger Java 生态下也可以考虑 Spring Rest Docs |
 | 12 balabalaguguji 2021 年 3 月 10 日 可以用易文档编写 https://easydoc.xyz ，它也可以一键生成文档，也可以从注释生成文档。预览效果： https://www.easydoc.xyz/s/17790664 截图 https://i.loli.net/2021/03/10/jVQdKMkJ4FPevui.png |
 | 13 liuzhaowei55 2021 年 3 月 10 日 via iPhone 手写 |
 | 14 bigpigeon 2021 年 3 月 10 日 swagger |
| 15 bigpigeon 2021 年 3 月 10 日 写了一个通过 go 框架生成 swagger 代码的 api，只要实现 api 就能自动生成 swagger |
 | 16 SjwNo1 2021 年 3 月 10 日 手写+1 |
 | 17 cocowind 2021 年 3 月 10 日 yapi docker 手写 |
 | 18 jowan 2021 年 3 月 10 日 swag |
 | 19 zhaorunze 2021 年 3 月 10 日 我还以为手写了个框架，仔细一想，可能是手写文档。。。 |
 | 20 ghouleztt 2021 年 3 月 10 日 swagger |
 | 21 Molita 2021 年 3 月 10 日 swagger 然后 用 redoc 展示 |
 | 22 NoneUndefined 2021 年 3 月 10 日 swagger+插件直接变 doc |
 | 23 mcfog 2021 年 3 月 10 日 重要的不是怎么生成，而是数据源在哪里，怎么管理 |
 | 24 h82258652 2021 年 3 月 10 日 swagger，部分生成不了的用 docfx |
 | 25 oneend 2021 年 3 月 10 日 只有我用 gitbook 吗？ |
 | 26 www5070504 2021 年 3 月 10 日 swagger 只要增加几行注释 很好用.. |
 | 27 a62527776a 2021 年 3 月 10 日 apidoc |
 | 28 Rekkles 2021 年 3 月 10 日 yapi |
 | 29 star7th 2021 年 3 月 10 日 3 |
 | 30 journalistFromHK 2021 年 3 月 10 日 上一家公司，老板写 java，啥是文档？不存在的，自己去看 controller 吧 |
 | 31 so1n 2021 年 3 月 10 日 自己写了一个库来自动生成 https://github.com/so1n/pait |
 | 32 henryhu 2021 年 3 月 10 日 apidoc |
 | 34 KisekiRemi 2021 年 3 月 10 日 对接的给我一个 swagger |
 | 35 cat007 2021 年 3 月 10 日 swagger+yapi |
 | 36 AngryPanda 2021 年 3 月 10 日 md 手写 、YAPI |
 | 37 evam 2021 年 3 月 10 日 postman 自己调试接口，然后 postman 分享，coding 自动生成 |
 | 38 egfegdfr 2021 年 3 月 10 日 smart-doc 感觉 swagger 的侵入性太强了 |
 | 39 jorneyr 2021 年 3 月 10 日 2 不喜欢 swagger 这种污染源码的工具，更喜欢用 yApi 这种类似的工具进行管理。 |
 | 41 monkeyWie 2021 年 3 月 10 日 swagger 然后自动同步到 yapi |
 | 42 scxiazi 2021 年 3 月 10 日 restdoc |
 | 43 putaozhenhaochi 2021 年 3 月 10 日 借楼问下，各位是先定义接口 还是先写代码 |
 | 44 MarioLuo 2021 年 3 月 10 日 YapiIdeaUploadPlugin IDEA 插件基于 JavaDoc 注释生成文档，上传到 yapi 中. |
 | 45 xnotepad 2021 年 3 月 10 日 自己写了个 https://apidoc.tools |
 | 46 chogath 2021 年 3 月 10 日 swagger + yapi，永远滴神 |
 | 47 newmlp 2021 年 3 月 10 日 md 手写 |
 | 48 offswitch 2021 年 3 月 10 日 @putaozhenhaochi 通常的说法是先写定义再写代码，不过大部分公司根本就没这要求，爱咋咋 |
 | 49 alienx717 2021 年 3 月 10 日 md 手写 |
 | 50 XCFOX 2021 年 3 月 10 日 目前用过最舒服的是 GraphQL 。文档和接口无缝结合。接口还是强类型的。前端能直接根据 graphql 接口地址生成接口类型 |
 | 51 20200924 2021 年 3 月 10 日 作为前端人员，感觉看 yapi 比看 swagger 舒服很多 |
 | 52 justin2018 2021 年 3 月 10 日 每次 API 有啥修改 就发一份 word 文档 真是 不好吐槽 |
 | 53 54xavier 2021 年 3 月 10 日 swagger |
 | 54 sannyzeng 2021 年 3 月 10 日 yapi |
 | 55 fuyangyishi0 2021 年 3 月 10 日 没人用 RAP 吗 |
 | 56 Gunn27 2021 年 3 月 10 日 |
 | 57 guiling 2021 年 3 月 10 日 yapi |
 | 58 qW7bo2FbzbC0 2021 年 3 月 10 日 因为 go 没有便捷的 swagger 工具，我转 spring 这种插件成熟的框架了 |
 | 59 yang2048 2021 年 3 月 10 日 swagger 或者 knife4j |
 | 60 zhyd1997 2021 年 3 月 10 日 RESTful API，只有我用 Postman 写文档吗。。。 |
 | 61 salenpeng 2021 年 3 月 10 日 1 swag /:狗头 |
 | 62 hakr 2021 年 3 月 10 日 @YadongZhang #60 俺也用... |
 | 63 freebird1994 2021 年 3 月 10 日 swagger + yapi |
 | 64 nowtg 2021 年 3 月 10 日 写 protobuf 然后生成 swagger |
| 65 nowtg 2021 年 3 月 10 日 使用 protobuf 定义，只要想改接口参数，proto 就必须修改，swagger 肯定也是最新的 |
 | 66 ERRASYNCTYPE 2021 年 3 月 10 日 实习生写 |
 | 67 asanelder OP @ERRASYNCTYPE #66 铁子, nb |
 | 68 m1ch3ng 2021 年 3 月 10 日 smart-doc，靠 javadoc 就能自动生成 |
 | 69 liuzhihang 2021 年 3 月 10 日 IDEA 插件 Doc View 纯 markdown 。不知道能不能满足你的需求。也欢迎 v2 小伙伴提 PR https://github.com/liuzhihang/doc-view  |
 | 70 Cbdy 2021 年 3 月 10 日 via Android 手写 |
| 71 liuzhihang 2021 年 3 月 10 日 发不出来图…… 看链接吧 https://plugins.jetbrains.com/plugin/15305-doc-view |
 | 72 noyidoit 2021 年 3 月 10 日 postman...... |
 | 73 dcatfly 2021 年 3 月 10 日 yapi 竟然有 1k+的 issue 没关闭，最近在用它内部的组件，代码写的一言难尽。。让我觉得这个项目还没死也是不容易。。 |
 | 75 ArrayBuffer 2021 年 3 月 11 日 我是前端, 对我来说最好的还是 `swagger` / `graphql`; `swagger` 是比较成熟的, 但对于阅读者来说还是有些地方体验不是很好, 为此我写了个脚本 greasyfork.org/zh-CN/scripts/401581, `graphql` 我也写了 greasyfork.org/zh-CN/scripts/416677 |
 | 76 xcatliu 2021 年 3 月 11 日 Swagger UI 感觉不是很好看，有没有其他替代？（除了 yapi ） |
 | 77 feitxue 2021 年 3 月 11 日 swagger 增强 ui 后的 knife4j,会舒服一点. |
 | 78 zaul 2021 年 3 月 11 日 语雀 |
| 79 balabalaguguji 2021 年 3 月 11 日 @xcatliu #76 易文档可以看下，真好用 |
| 80 balabalaguguji 2021 年 3 月 11 日 @vfxx #74 那肯定还没用过易文档 |
 | 81 ccvip 2021 年 3 月 11 日 我一直是用的 showdoc 私有化部署，易文档部署价格 8K，要不起。。。 易文档免费版竟然不支持导出 |
 | 82 liuliangsir 2021 年 3 月 18 日 @sss495088732 能问下，你用的是哪个 yapi docker 镜像 |
| 83 cocowind 2021 年 3 月 18 日 |
 | 84 smartdoc647 2021 年 7 月 22 日 1 smart-doc+torna，目前开源产品中国内最成熟的，科大讯飞和顺丰这些公司都在用，不是吹出来的。 |
Select Language