深度解析Go工具链(四):Golang环境变量的设置与查看

发表时间: 2023-07-21 23:41

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 命令查看。