開發中有的人喜歡用swagger2，也有人喜歡用yapi，總之是各有各愛，好在yapi上支持多種數據導入，也支持swagger格式，這個對於yapi的版本是有要求的，v1.3.19以前的不支持。
在yapi的官方教程裡，提到了項目設置裡token就是後續版本裡新增，且要swagger新增配置文件需要的，之前就是忽略版本問題，折騰好半天。
搜尋網絡上資料還有另一種方式，就是YapiIdeaUploadPlugin插件，這個idea還是好用呀。以前的時候還是手動拷貝到yapi上，今次看到這個插件真好呀。
打開idea，preferneces->plugins-> install plugin from disk（或者搜索 yapiupload)
配置文件.idea 文件夾下的misc.xml
<component name="yapi">
<option name="projectToken">ea4ad1b6033375dac2d01fe713c43745cd5cc1b71773844443bd77a61179bd4e</option>
<option name="projectId">11</option>
<option name="yapiUrl">http://127.0.0.1:3000</option>
<option name="projectType">api</option>
</component>
可以單個接口上傳那就選中方法右鍵上傳即可。也可以批量上傳那就選中類名 右鍵上傳。
相對而言，我還是更推薦yapi，沒有了無關代碼侵入，節省時間，維護代碼整潔，而且可以通過工具反向規範代碼注釋，閱讀起來輕鬆自如。