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的存储路径下执行以上代码,否则无法登录网页。