swagger本地环境配置

swagger本地环境配置

关于swagger我目前也是刚接触，还没有深入了解，之后再不断补充，有要用到swagger的朋友可以通过本文快速完成swagger的本地环境配置。

一. 下载Nodejs。在官网下载最新的 Nodejs：https://nodejs.org/en/。当前常用的版本是 10.13.0。

这里需要注意的是，在 Nodejs 安装安成后会在一个新的 cmd 中自动安装相应的 package，安装过程中可能会重启电脑，而且在某些时候重启过后会提示 warning，并再次重新启动电脑，此时，只需要将打开的 cmd 窗口关闭即可，不影响后续的操作。在安装完成后，可以测试 node 和 npm（即上面说的 node 包管理器）的版本。

node -v
npm -v

二. 下载Swagger-editor和Swagger-ui

git clone https:``//github.com/swagger-api/swagger-editor
git clone https:``//github.com/swagger-api/swagger-ui.git

三. 安装http-server。当前默认端口是8080，如果被占用可以通过命令修改：http-server –p 8081

npm install -g http-server
http-server –p ``8081` `swagger-editor

四. 启动http-server，此时，便可以在网页上输入 http://localhost:808，或者输入 shell 中提示的地址登陆 Swagger-editor 了，界面如图所示。如果输入网址出错，可以先尝试更换浏览器重新进入:

http-server swagger-editor
http:``//localhost:8081

注意：请在swagger-editor的存储路径下执行以上代码，否则无法登录网页。