Go 工具链详解（四）： Golang环境变量设置和查看工具 go env

go env 作用

go env 是 Go 工具链中的一个命令，用于设置和查看当前 Golang 环境的相关信息，对于理解、编译和运行 Golang 程序非常有用。

go 提供的命令及 go 程序的编译运行都会使用到环境变量，如果未设置对应的环境变量，go 则会使用其默认设置。默认情况下，env 以 shell 脚本（在Windows上是批处理文件）的形式打印环境变量。如果查看指定的一个或多个变量，每个变量的值会占用一行。

go env 常用的参数说明：

• -json：以 json 格式打印环境变量。
• -u：后面需要跟上一个或多个参数值，如果使用’go env -w’设置了指定环境变量的值，则取消对应的值设置。
• -w：后面需要跟上一个或多个形式为 NAME=VALUE 的参数，并将指定环境变量的默认设置更改为给定值。

go env 使用方法和使用示例

列出 go 环境变量

go env

会输出如下内容，由于内容太多，只列出几个，其他使用省略号代替：

GO111MODULE="on"
GOARCH="amd64"
GOBIN=""
GOCACHE="/Users/luduoxin/Library/Caches/go-build"
...

以 json 格式列出环境变量：

 go env -json

会输出如下内容，由于内容太多，只列出部分，其他使用省略号代替：

{
        "AR": "ar",
        "CC": "clang",
        "CGO_CFLAGS": "-g -O2",
				...
}

查看看某个或者某几个 go 环境变量：

$ go env GOPATH 
/Users/luduoxin/go
$ go env GOPATH GOROOT
/Users/luduoxin/go
/usr/local/opt/go/libexec

更改某个或者某几个 go 环境变量：

$ go env GOPATH=/Users/ning/go
$ go env GOPATH=/Users/ning/go GOROOT=/usr/local/go/libexec

如果对应的环境变量已经在操作系统环境变量配置文件中配置过，使用go env -w 方式修改是无效的，会报出如下错误：

warning: go env -w GOPATH=... does not override conflicting OS environment variable

go 环境变量及作用

接下来看一下通用环境变量：

• GO111MODULE：用来控制使用 go mod 模式还是 GOPATH 模式，值为 off, on 或 auto。
• GCCGO：gccgo 命令运行’go build -compiler=gccgo’。
• GOARCH：当前架构，例如 amd64, 386, arm, ppc64等。
• GOBIN：Go 命令的默认二进制目录，即’go install’将安装命令的目录。
• GOCACHE：Go 命令的缓存目录。
• GOMODCACHE：go命令将存储下载模块的目录。
• GODEBUG：启用各种调试工具，参见’go doc runtime’。
• GOENV：Go 环境变量配置文件的位置。
• GOFLAGS：Go 命令的标志位参数。
• GOINSECURE：用于指定哪些域名下的仓库不校验CA证书。
• GOOS：当前操作系统，例如 linux，darwin，windows，netbsd 等。
• GOPATH：Go 项目的根目录。
• GOPROXY：Go module 代理的 URL。
• GOROOT：Golang 安装的根目录。
• GOSUMDB：要使用的校验数据库的名称以及可选的公钥和URL
• GOTMPDIR：go 命令写入的目录，临时的源文件、包和二进制文件。
• GOVCS：列出可能与匹配服务器一起使用的版本控制命令。
• GOWORK：workspace 设置。

除了通用环境变量，还有使用 cgo 相关的环境变量、特定系统架构的环境变量、专用环境变量和只能通过 go env 读取的环境变量，这些本文就不做具体讲解了，详细信息可以通过 go help environment 命令查看。