前言

写代码的快乐，在于通过一顿猛如虎的操作，实现了自己设计的逻辑流程。（也可能并不是很快乐！）

这时候，你以为就可以关机么？

还有接口文档没写呢！

哈？

开始进入无限 CV 模式，各种请求参数、必填非必填、请求返回示例！

几分钟后…… 🤬🤬🤬

我要写个 IDEA 插件，以后再也不想手写文档了！

下面，来看看我肝出来的插件吧！

1

功能介绍

插件名字必须得先介绍，Doc View，有兴趣的小伙伴直接在 IDEA 中搜索插件即可。

• Controller/Dubbo 接口文档生成
• 支持 Validation、Swagger 等注解
• Markdown 接口查看、预览、复制、导出
• 支持自定义生成接口的 Markdown 模版
• 支持界面编辑文档、注释、并同步保存到代码注释中
• 支持在编辑实体界面, 将实体复制为 Json 字符串
• 支持上传文档到 YApi
• 支持自定义配置

功能就不留悬疑了，直接介绍出来，下面用再用图文介绍下，毕竟干巴巴的说文字介绍，也太么得感情了！

2

主界面

生成 Markdown

生成 Markdown 文档包含：接口名称、接口描述、请求路径、请求方式、请求参数、请求示例、返回参数、返回示例。

这些全都是根据方法的注释、注解、出参、入参解析出来的

小伙伴想看源码或者提交 PR，文末有 github 地址。

为什么生成 Markdown？

因为格式比较好看，并且很容易转换为 Html、PDF、Word 等格式。

直接将 Markdown 文本复制到 VS Code，预览图如下：

• 自定义 Markdown

这里也是支持一定程度上自定义 Markdown 的格式的。

可以在 IDEA 设置选项中，找到 Doc View 的相关设置，进行自定义 Markdown 的样式。

• 字段注释设置

这里支持 Swagger3、Swagger、注释 tag 的方式设置相关信息。

面板功能

• 预览

左下角直接使用 IDEA 内置 Markdown 面板进行预览文件。

IDEA 2020.2 以上版本才可以哦！

• 导出

在面板左右两边，分别有两个导出按钮，对应着批量导出和导出当前。

• 复制

直接将 Markdown 文本复制到剪贴板。不过也可以直接在文本域中使用 ⌘ + A 全选后复制。

也可以 ⌘ + F 唤出搜索框，不过一般很少使用。

上传 YApi

如果说生成 Markdown 文本，是为了方便复制到 ShowDoc 之类支持 Markdown 的 API 文档网站，那 Api 呢？

这里也是支持的！

直接通过上传按钮，可以一键上传到 YApi。

不过记得设置地址和 Token。

文档编辑

核心功能除了生成 Markdown、预览、上传 YApi 之外，这个功能相对来说还不是很完善。

那就是编辑文档及字段。

Doc Editor 可以在方法、实体类中使用，并生成相应的注释。

并且可以将实体类复制为 Json。

这个功能和 Toolkit 类似。

3

总结

整体功能就这些了，基本可以满足大部分文档需求。其他的就是边边角的修修改改。

来来来，小伙伴们一起用起来，帮忙踩踩坑，提提建议。

项目&反馈地址：https://github.com/liuzhihang/doc-view

赶紧下载去吧！