一.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.下载项目 并且解压

　　4. 进入swagger-editor文件夹。运行http-server命令。 

　　5. 进入 就可以看到swagger页面了。