go Echo框架集成Swagger 自动生成api文档

文章原发布地址https://xiaoyou66.com/archives/2322
本文章为个人博客的备份版本、作者：小游、作者博客：点击访问

[info]
之前的api文档一直都是手写的，使用起来非常麻烦，所以我打算采用swagger来自动生成api文档，减少我的工作量同时接口更新后文档也能自动更新，减少自己维护文档的麻烦，废话不多说，直接开始集成。
[/info]

swagger官方有对echo专门开发过适配的包，项目地址：https://github.com/swaggo/echo-swagger

安装swagger

安装命令:go get github.com/swaggo/swag/cmd/swag

安装可能会失效，建议在命令行开启代理:

set http_proxy=http://0.0.0.0:8000
set https_proxy=http://0.0.0.0:8000

初始化swagger

自己切换到项目目录下初始化swagger：swag init

然后我们就会看到项目里面多了一个docs目录

开始集成

我们下载swagger的echo中间件
go get -u github.com/swaggo/echo-swagger

然后我们引入中间件

import "github.com/swaggo/echo-swagger" // echo-swagger middleware

<