准备学习go语言,打算用go的gin框架来写写web接口。然而用文档的教程来运行,却死活都跑不起来,写下问题和解决方法,让遇到问题的同伴早日脱离苦海
首先简单的说下正常要运行一个项目步骤,我是windows环境:
安装golang
1. 下载安装包安装
2. 在cmd中输入go回车,有输出则说明安装正常
3. 一般安装的时候程序会自动添加,无需人工干预
检查GOPATH
1. 可以在cmd中查看set GOPATH
2. 或者在"我的电脑"-"属性"-"高级"-"环境变量"中查看和添加
3. 正常go安装,会自动添加,我本机GOPATH=C:\Users\Administrator\go;
安装gin
1. 接下来安装gin,框架文档介绍:go get -u github.com/gin-gonic/gin
2. 这时候开始遇到问题了,常遇问题资源加载不了,解决方法是使用代理(这块有个 go env 的命令,可以查看当前配置),在cmd中运行:
go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.io,direct
3. 设置后,重新运行: go get -u github.com/gin-gonic/gin,可以很快速的安装
运行项目
1. 在C:\Users\Administrator\go\ 下创建 src/gin/ 文件夹,创建main.go 文件,添加文档说的代码
package main
import "github.com/gin-goinc/gin"
func main() {
r := gin.Default()
r.GET("/ping", func(c *gin.Context) {
c.JSON(200, gin.H{
"message": "pong",
})
})
r.Run() // listen and serve on 0.0.0.0:8080 (for windows "localhost:8080")
}
2. 在cmd中,进入C:\Users\Administrator\go\src\gin\目录,运行命令: go run .\main.go
3. 这时候问题又来了,报错:main.go:3:8: cannot find module providing package github.com/gin-gonic/gin: working directory is not part of a module
4. 解决方法,当前目录分别运行下面两句代码:
go mod init gin
go mod edit -require github.com/gin-gonic/gin@latest
5. 上面运行后,再运行 go run .\main.go,就可行了。这其中涉及到go mod包依赖管理 ,类似前端npm的package.json,有兴趣可以深入了解
问题回顾
上面几点只是说明解决方法,这其中遇到的问题,甚至一度怀疑我安装的版本有问题
1. 我使用的是go 1.14.2,在运行gin的时候 go run .\main.go ,会报错: main.go:3:8: cannot find module providing package github.com/gin-gonic/gin: working directory is not part of a module
2. 此时经过几次调试,发现如果运行 go env -w GO111MODULE=off(关闭模块管理)报错变成
main.go:3:8: cannot find package "github.com/gin-gonic/gin" in any of: c:\go\src\github.com\gin-gonic\gin (from $GOROOT) C:\Users\Administrator\go\src\github.com\gin-gonic\gin (from $GOPATH)
3. 这时 cannot find package "" in any of 这个报错,就把我引到到设置GOPATH问题集合上,调试很久,发现并不能解决
4. 此时我怀疑起了代理设置,特别是go get 之后包是放在 $GOPATH\src\pkg下的,教程说是在src下面的,这点很是诡异, 当 go env -w GO111MODULE=off (关闭模块管理),这个时候go get 命令是不走代理,而是走实际地址,下载速度异常慢,经常下载失败,但是模块包能被下载到 $GOPATH/src目录下,这点和网上说的go目录结构一致,此时在main.go中 import 包,运行也不会报错( gin的包比较大,正常是下载失败的,我当时用go get github.com/astaxie/beedb试了另一个包)
5. gin用go get 下载是不会成功的,我直接在github下载包放在 $GOPATH/src 下,但是缺少依赖,无法运行,后续又把 $GOPATH\src\pkg\mod中的包复制到 $GOPATH\src,还是不能运行。
6. 最后发现gin中有个go.mod的文件,查阅了相关资料,才找到解决方法。
总结
在使用 GOPROXY 的时候,开启了 GO111MODULE,导致包管理非官方所说的在 $GOPATH\src\,而是去了 $GOPATH\src\pkg\目录下,此时就需要用go mod引入这些包 require github.com/gin-gonic/gin@latest ,解决import获取不了包的问题。
有疑问加站长微信联系(非本文作者)