一.swagger简介
swagger是一套开源的API设计工具，包括Swagger UI和Swagger Editor等。其中swagger edit是用来编辑接口文档的小程序，非常简单易用。在官网上分为在线编辑和下载代码线下编辑的两种编辑方式。
swagger是通过YAML来定义你的接口规范，可以通过yaml格式（标准json可以自动转换成yaml格式）的接口文档帮你生成不同语言的服务端和客户端代码。
二.swagger安装
1.下载安装node.js
下载地址：https://nodejs.org/en/download/
验证是否安装成功
2.执行命令
npm install -g http-server
此时如果报错误信息如下：
命令改为
sudo npm install -g http-server
3.下载项目https://github.com/swagger-api/swagger-editor 并且解压
4. 进入swagger-editor文件夹。运行http-server命令。
5. 进入http://127.0.0.1 就可以看到swagger页面了。