Go语言基础 – 环境变量 GOROOT GOPATH GOPROXY Module

1. GOROOT

GOROOT的含义

GOROOT也是Go语言中的一个环境变量，用于指定Go语言的安装目录。它是Go语言标准库和工具链的根目录，包含了Go语言的各种标准库、编译器、调试器等。

GOROOT的作用
GOROOT定义了Go语言的安装目录，其中包含了Go语言的标准库和工具链。在开发过程中，我们可以使用GOROOT来访问和使用标准库中提供的各种功能和工具。

通过正确配置GOROOT，我们可以保证在开发过程中能够正确引用和调用Go语言的标准库，从而编写高效、可靠的代码。

GOROOT的目录

|-- api  api文件夹中存放了Go API检查器的辅助文件，包括公开的变量、常量及函数等。
|-- bin  bin文件夹中存放了所有由官方提供的Go语言相关工具的可执行文件
|-- doc  doc文件夹中存放了Go语言几乎全部HTML格式的官方文档和说明
|-- lib  lib文件夹中存放引用的库文件
|-- misc misc文件夹中存放各类编辑器或IDE（集成开发环境）软件的插件，辅助开发者查看和编写Go语言代码
|-- pkg  pkg文件夹用于在构建安装后，保存Go语言标准库的所有归档文件。
|-- src  src文件夹中存放了所有的标准库、Go语言工具及相关底层库（C语言实现）的源码
|-- test test文件夹中存放了测试Go语言自身代码的文件

2. GOPATH

GOPATH的含义

GOPATH是Go语言中的一个环境变量，用于指定Go开发环境中的工作目录。它是我们自己项目的根目录，用于存放项目源代码、依赖包以及编译后的可执行文件等。

从Go 1.8版本开始，Go开发包在安装完成后会为GOPATH设置一个默认目录，并且在Go1.14及之后的版本中启用了Go Module模式之后，不一定非要将代码写到GOPATH目录下，所以也就不需要我们再自己配置GOPATH了，使用默认的即可

GOPATH 目录

|-- bin  bin目录与pkg目录类似，在通过go install命令完成安装后，保存由Go命令源码文件生成的可执行文件。
|-- pkg  pkg目录主要用于存放经由go install命令构建安装后的代码包（包含Go库源码文件）的“.a”归档文件。
|-- src  src目录主要用于以代码包的形式组织并保存Go源码文件。代码包与src的子目录相对应。

如何正确配置GOPATH与GOROOT

配置GOPATH：

创建一个目录，用作GOPATH的根目录，例如：mkdir ~/go。
将该目录设置为GOPATH环境变量的值，例如：export GOPATH=~/go。
在GOPATH下创建src、pkg和bin三个目录，例如：mkdir -p ~/go/src ~/go/pkg ~/go/bin。
配置GOROOT：

下载并安装Go语言的发行版，可从官方网站（https://golang.org/dl/）获取。
将Go语言的安装目录设置为GOROOT环境变量的值，例如：export GOROOT=/usr/local/go。

3. GOPROXY

这个环境变量主要是用于设置 Go 模块代理（Go module proxy），其作用是用于使 Go 在后续拉取模块版本时能够脱离传统的 VCS 方式，直接通过镜像站点来快速拉取。

GOPROXY 的默认值是：https://proxy.golang.org,direct，由于某些原因国内无法正常访问该地址，所以我们通常需要配置一个可访问的地址

3.1 GOPROXY 配置

打开你的终端并执行

$ go env -w GO111MODULE=on
$ go env -w GOPROXY=https://goproxy.cn,direct

macOS 或 Linux

打开你的终端并执行

$ export GO111MODULE=on
$ export GOPROXY=https://goproxy.cn

或者

$ echo "export GO111MODULE=on" >> ~/.profile
$ echo "export GOPROXY=https://goproxy.cn" >> ~/.profile
$ source ~/.profile

4. Module

go module是Go1.11版本之后官方推出的版本管理工具，并且从Go1.13版本开始，go module将是Go语言默认的依赖管理工具。

要启用go module支持首先要设置环境变量GO111MODULE，通过它可以开启或关闭模块支持，它有三个可选值：off、on、auto，默认值是auto。

1. GO111MODULE=off禁用模块支持，编译时会从GOPATH和vendor文件夹中查找包。
2. GO111MODULE=on启用模块支持，编译时会忽略GOPATH和vendor文件夹，只根据 go.mod下载依赖。
3. GO111MODULE=auto，当项目在$GOPATH/src外且项目根目录有go.mod文件时，开启模块支持。

简单来说，设置GO111MODULE=on之后就可以使用go module了，以后就没有必要在GOPATH中创建项目了，并且还能够很好的管理项目依赖的第三方包信息。

使用 go module 管理依赖后会在项目根目录下生成两个文件go.mod和go.sum。

4.1 go module 常用操作详解

GO 设置代理

打开模块支持

go env -w GO111MODULE=on

取消代理支持

go env -w GOPROXY=direct

关闭包的有效性验证

go env -w GOSUMDB=off

设置不走 proxy 的私有仓库或组，多个用逗号相隔（可选）

go env -w GOPRIVATE=git.mycompany.com,github.com/my/private

国内常用代理列表

“direct” 为特殊指示符，用于指示 Go 回源到模块版本的源地址去抓取(比如 GitHub 等)，当值列表中上一个 Go module proxy 返回 404 或 410 错误时，Go 自动尝试列表中的下一个，遇见 “direct” 时回源，遇见 EOF 时终止并抛出类似 “invalid version: unknown revision…” 的错误。

官方全球代理

go env -w GOPROXY=https://proxy.golang.com.cn,direct
go env -w GOPROXY=https://goproxy.io,direct
go env -w GOSUMDB=gosum.io+ce6e7565+AY5qEHUk/qmHc5btzW45JVoENfazw8LielDsaI+lEbq6
go env -w GOSUMDB=sum.golang.google.cn

七牛云

go env -w GOPROXY=https://goproxy.cn,direct
go env -w GOSUMDB=goproxy.cn/sumdb/sum.golang.org

阿里云

go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct
# GOSUMDB 不支持

GoCenter

go env -w GOPROXY=https://gocenter.io,direct
# 不支持 GOSUMDB

百度

go env -w GOPROXY=https://goproxy.bj.bcebos.com/,direct
# 不支持 GOSUMDB

4.2 go mod

常用的go mod命令如下：

go mod download    下载依赖的module到本地cache（默认为$GOPATH/pkg/mod目录）
go mod edit        编辑go.mod文件
go mod graph       打印模块依赖图
go mod init        初始化当前文件夹, 创建go.mod文件
go mod tidy        增加缺少的module，删除无用的module
go mod vendor      将依赖复制到vendor下
go mod verify      校验依赖
go mod why         解释为什么需要依赖

go.mod文件

module hello

go 1.19

require (
	github.com/gin-contrib/cors v1.4.0
	github.com/gin-gonic/gin v1.8.1
	gorm.io/driver/sqlite v1.4.3
	gorm.io/gorm v1.24.2
)

require (
	github.com/gin-contrib/sse v0.1.0 // indirect
	github.com/go-playground/locales v0.14.0 // indirect
	github.com/go-playground/universal-translator v0.18.0 // indirect
)

• module用来定义包名
• require用来定义依赖包及版本
• indirect表示间接引用

4.3 go get

在项目中执行go get命令可以下载依赖包，并且还可以指定下载的版本。

1. 运行go get -u将会升级到最新的次要版本或者修订版本(x.y.z, z是修订版本号， y是次要版本号)
2. 运行go get -u=patch将会升级到最新的修订版本
3. 运行go get package@version将会升级到指定的版本号version

如果下载所有依赖可以使用go mod download命令。