Go:Unresolved reference xx(2)
1.环境
GoLand版本:2021.1.2
Go版本:1.16.4
EB@DESKTOP-K45IA6V MINGW64 ~
$ go version
go version go1.16.4 windows/amd64
2.背景
我们通常执行go get指令完成第三方依赖库的安装。
go get指令具体做了哪些操作呢?
实际上,go get指令仅下载第三方库源码,存储到本地$GOPATH/pkg/mod目录中。
执行go get指令成功后,就可以在项目中import导入、使用。
以安装gopkg.in/yaml.v2为例:
项目目录结构及内容:
此时,$GOPATH/pkg/mod中:
EB@DESKTOP-K45IA6V MINGW64 ~/Desktop/test1280
$ go env | grep GOPATH
set GOPATH=D:\gopath
EB@DESKTOP-K45IA6V MINGW64 ~/Desktop/test1280
$ ls -l $GOPATH
total 0
安装第三方库:gopkg.in/yaml.v2
EB@DESKTOP-K45IA6V MINGW64 ~
$ go get gopkg.in/yaml.v2
go: downloading gopkg.in/yaml.v2 v2.4.0
go get执行成功后,源码已下载存储到本地$GOPATH/pkg/mod中:
EB@DESKTOP-K45IA6V MINGW64 ~
$ ls -l $GOPATH/pkg/mod/gopkg.in/
total 4
drwxr-xr-x 1 EB 197609 0 May 26 22:52 yaml.v2@v2.4.0
此时,go.mod文件没有发生变化:
EB@DESKTOP-K45IA6V MINGW64 ~/Desktop/test1280
$ cat go.mod
module test1280
go 1.16
尝试在项目中使用yaml库:
如上所示,yaml库不被GoLand解析识别,显示Unresolved reference ‘yaml’。
此时编译,报错如下:
EB@DESKTOP-K45IA6V MINGW64 ~/Desktop/test1280
$ go run main.go
# command-line-arguments
.\main.go:4:15: undefined: yaml
解决办法:
step1:手动import gopkg.in/yaml.v2库:
step 2:同步项目依赖:
如果没有显示上图提示,可以将鼠标放到import "gopkg.in/yaml.v2"处,按键Alt+Enter:
此时,GoLand将输出提示:
并且,GoLand可以解析识别yaml库:
查看项目go.mod文件:
EB@DESKTOP-K45IA6V MINGW64 ~/Desktop/test1280
$ cat go.mod
module test1280
go 1.16
require gopkg.in/yaml.v2 v2.4.0
可见项目go.mod文件在sync时被修改,新增一条依赖项:require gopkg.in/yaml.v2 v2.4.0
再次尝试终端运行:(更换为其他错误)
EB@DESKTOP-K45IA6V MINGW64 ~/Desktop/test1280
$ go run main.go
# command-line-arguments
.\main.go:6:2: data declared but not used
.\main.go:6:8: err declared but not used
3.总结
a.执行go get指令,仅是下载第三方库源码到$GOPATH/pkg/mod目录中保存,并不修改go.mod文件
b.要在项目中引入第三方库源码,需要手动import并执行sync同步,此时go.mod将被自动修改添加依赖
c.go.mod新增依赖项之后,GoLand可以解析识别第三方依赖库,并且可以编译、运行成功
4.问题
请查看go.mod是否包含对应依赖库,当以下问题情况出现时:
a.编译、运行项目时出现:command-line-arguments undefined xxx
b.在GoLand中Unresolved reference标红依赖库时
5.附录
https://github.com/go-yaml/yaml