彻底搞懂GOROOT、GOPATH、PATH、mod管理和gopath管理项目的区别

1、GOPATH 和 GOROOT

不同于其他语言,go中没有项目的说法,只有包, 其中有两个重要的路径,GOROOT 和 GOPATH

Go开发相关的环境变量如下:

GOROOT:GOROOT就是Go的安装目录,(类似于java的JDK)
GOPATH:GOPATH是我们的工作空间,保存go项目代码和第三方依赖包
GOPATH可以设置多个,其中,第一个将会是默认的包目录,使用 go get 下载的包都会在第一个path中的src目录下,使用 go install时,在哪个GOPATH中找到了这个包,就会在哪个GOPATH下的bin目录生成可执行文件

2、修改 GOPATH 和 GOROOT

GOROOT
GOROOT是Go的安装路径。GOROOT在绝大多数情况下都不需要修改

/usr/local/goC:\Go
D:\development\go

可以看到GOROOT下有bin,doc和src目录。bin目录下有我们熟悉的go和gofmt工具。可以认为GOOROOT和Java里的JDK目录类似。

GOPATH
GOPATH是开发时的工作目录。用于:

保存编译后的二进制文件。
go get和go install命令会下载go代码到GOPATH。
import包时的搜索路径
使用GOPATH时,GO会在以下目录中搜索包:

GOROOT/src:该目录保存了Go标准库代码。
GOPATH/src:该目录保存了应用自身的代码和第三方依赖的代码。
假设程序中引入了如下的包:

import "Go-Player/src/chapter17/models"

3、HelloWord——GOPATH版

(1)设置并查看GOPATH和GOROOT环境变量

D:\development\goD:\development\jetbrains\goland\workspace

(2)GOLand环境配置

D:\development\jetbrains\goland\workspace\src

pkg:存放自定义包的目录

src:存放项目源文件的目录

按如下指令进行配置

可在Settings中选择SDK和添加GOPATH

(3)测试

models:Student.go

main:hello.go
package main

import (
	//"./models"  //相对路径
	"Go-Player/src/ademo/models"  //根据GOPATH找
    //根据GOPATH:D:\development\jetbrains\goland\workspace,在其src目录下查找
    //即GOPATH/src/Go-Player/src/ademo/models
	"fmt"
)

func main() {
	stu := models.Student{
		Name: "张三",
	}
	fmt.Println(stu)
}

此篇文章仅介绍网上大部分GOPATH版本。Go语言Hello World都只简单地介绍了GOPATH版本。但是从Go的1.11版本之后,已不再推荐使用GOPATH来构建应用了。也就是说GOPATH被认为是废弃的,错误的做法。

4、一些踩坑经验

当你开启了GO111MODULE,仍然使用GOPATH模式的方法,在引入自定义模块时会报错。go mod具体使用将在下一篇介绍

GO111MODULE 有三个值:off, on和auto(默认值)。

GO111MODULE=off,go命令行将不会支持module功能,寻找依赖包的方式将会沿用旧版本那种通过vendor目录或者GOPATH模式来查找。
GO111MODULE=on,go命令行会使用modules,而一点也不会去GOPATH目录下查找。
GO111MODULE=auto,默认值,go命令行将会根据当前目录来决定是否启用module功能。这种情况下可以分为两种情形:
当前目录在GOPATH/src之外且该目录包含go.mod文件,即使用go mod对项目的第三方依赖进行管理,不再使用gopath的方式
当前文件在包含go.mod文件的目录下面。

当modules 功能启用时,依赖包的存放位置变更为$GOPATH/pkg,允许同一个package多个版本并存,且多个项目可以共享缓存的 module。

(1)使用了了相对路径:import “./models”

build command-line-arguments: cannot find module for path _/D_/devimpot …/
import "Go-Player/src/ademo/models"

于是我们把上面的import改成了结合GOPATH的如上形式

package Go-Player/src/ademo/models is not in GOROOT D:/development/go/src/GPlayer/src/ademo/models

(3)彻底解决方法:用go env -u 恢复初始设置

不再使用go mod:

go env -w GO111MODULE=offgo env -w GO111MODULE=autogo env -u GO111MODULE

4、最佳实践

#初始化并创建以“当前项目根目录”为moudles名称的go.mod文件
go mod init 当前项目根目录
#剔除无用包,拿取有用包,准备代码所需环境(第三方依赖)
go mod tidy
#编译运行即可
#注意:当前mod文件里的moudles名称必须与当前项目目录名保持一致,否则会报错!