gin使用 swag 记录

莫夏_b560 · · 4163 次点击 · · 开始浏览    
这是一个创建于 的文章,其中的信息可能已经有所发展或是发生改变。

1、go get -u github.com/swaggo/swag/cmd/swag

$ go get -u github.com/swaggo/swag/cmd/swag

报错:go 获取golang.org/x/tools包失败

go get  golang.org/x/tools/go/packages
package golang.org/x/tools/go/packages: unrecognized import path "golang.org/x/tools/go/packages" (https fetch: Get https://golang.org/x/tools/go/packages?go-get=1: proxyconnect tcp: net/http: TLS handshake timeout)

替代的解决办法就是直接去https://github.com/golang/tools.git 克隆一份然后放到E:\gopath\src[golang.org](http://golang.org/)\x\tools目录下

2、安装 gin-swagger
$ go get -u github.com/swaggo/gin-swagger

$ go get -u github.com/swaggo/gin-swagger/swaggerFiles

3、编写API注释

4、生成
进入项目根目录

[$ gin-blog]# swag init
2018/03/13 23:32:10 Generate swagger docs....
2018/03/13 23:32:10 Generate general API Info
2018/03/13 23:32:10 create docs.go at  docs/docs.go

坑爹的出现了下面的报错,然后懵逼了,从来没遇到过,后来仔细看了下报错的原因,去把对应目录下得testdata删掉了。然后就成功了。


image.png
ParseFile panic:golang.org\x\tools\cmd\fiximports\testdata\s                                                                                                                                                                                                         rc\old.com\bad\bad.go:2:43: expected 'package', found 'EOF'
panic: ParseFile panic:golang.org\x\tools\cmd\fiximports\testdata\src\old.com\ba                                                                                                                                                                                                         d\bad.go:2:43: expected 'package', found 'EOF'
image.png

有疑问加站长微信联系(非本文作者)

本文来自:简书

感谢作者:莫夏_b560

查看原文:gin使用 swag 记录

入群交流(和以上内容无关):加入Go大咖交流群,或添加微信:liuxiaoyan-s 备注:入群;或加QQ群:692541889

4163 次点击  
加入收藏 微博
暂无回复
添加一条新回复 (您需要 登录 后才能回复 没有账号 ?)
  • 请尽量让自己的回复能够对别人有帮助
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
  • 支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet
  • 图片支持拖拽、截图粘贴等方式上传