前言任何项目在开发完成后都需要编写接口文档,而手动编写文档即消耗人力又可能由于维护不及时导致文档和项目版本不一致,反之如果使用swagger在项目更新的同时自动生成相应的接口文档则可以避免上述问题。由于swagger2.0的规范依赖于openapi 3.0版本的规范，所以在使用swagger生成文档前，了解和掌握openapi的规范是必要的,所以我下边列出了openapi文档的常用示例并赋予中文说