之前在和一些技术同事聊到了接口文档这事，并提到了swagger，收到的反馈有这些： “很麻烦！接口文档要和代码耦合在一起” “字段说明要写好几遍！一改要改好多地方！” "请求参数想描述清楚要写一堆玩意儿！！"   我也看了下，控制器方法上要对每个参数这么描述，确实有点反人类啊！ @ApiImplicitParams({    @ApiImplicitParam(name="mobil