一、先看效果

1、生成yapi文檔的效果

2、生成postman格式數(shù)據(jù)并導(dǎo)入接口測試類后的效果（如postman、apifox等工具）

3、生成markdown格式文檔的效果

基于 Spring Boot + MyBatis Plus + Vue & Element 實(shí)現(xiàn)的后臺(tái)管理系統(tǒng) + 用戶小程序，支持 RBAC 動(dòng)態(tài)權(quán)限、多租戶、數(shù)據(jù)權(quán)限、工作流、三方登錄、支付、短信、商城等功能

項(xiàng)目地址：https://github.com/YunaiV/ruoyi-vue-pro

視頻教程：https://doc.iocoder.cn/video/

二、安裝

1、安裝EasyYapi插件

idea的頂部菜單欄選擇 文件 -> 設(shè)置 -> 插件，然后再marketplace里搜索easyYapi安裝即可

安裝完成后設(shè)置底部回出現(xiàn)EasyApi的欄目，選中進(jìn)行配置修改（我主要是改了下圖紅框的位置，不修改使用默認(rèn)配置也可以，自己可以試試使用json5和不適用json5的區(qū)別，我更喜歡看json5格式的文檔【也是最近才發(fā)現(xiàn)有這個(gè)格式的】）

2、安裝yapi接口文檔管理系統(tǒng)

如果只需要在postman等接口工具中使用，可以跳過此步驟

官方部署文檔：

https://hellosean1025.github.io/yapi/devops/index.html

注意 ：node.js不要安裝最高版本（我安裝最高版本時(shí)安裝yapi失敗，node.js重新安裝12.x版本后成功）

基于 Spring Cloud Alibaba + Gateway + Nacos + RocketMQ + Vue & Element 實(shí)現(xiàn)的后臺(tái)管理系統(tǒng) + 用戶小程序，支持 RBAC 動(dòng)態(tài)權(quán)限、多租戶、數(shù)據(jù)權(quán)限、工作流、三方登錄、支付、短信、商城等功能

項(xiàng)目地址：https://github.com/YunaiV/yudao-cloud

視頻教程：https://doc.iocoder.cn/video/

三、接口編寫

接口上的注釋自動(dòng)會(huì)生成接口名稱和接口的描述信息，實(shí)體類里的注釋也會(huì)自動(dòng)生成文檔里的字段說明

四、生成文檔

快捷鍵：Shift + Alt + E

更多使用教程見官網(wǎng)文檔：

https://easyyapi.com/index.html

如果選擇yapi，首次需要填寫一個(gè)yapi服務(wù)的地址，如：127.0.0.1:3000

然后需要填寫項(xiàng)目的token，這個(gè)token是yapi服務(wù)器新建項(xiàng)目后生成的token

審核編輯 ：李倩