Go 工具链详解(四): Golang环境变量设置和查看工具 go env
作者:mmseoamin日期:2023-12-19

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