Go：Unresolved reference xx(2)

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