Golang环境变量（go env）详解

发表时间: 2023-07-01 22:10

GO111MODULE

GO111MODULE 是 Go 1.11 版本引入的一个环境变量，用于控制 Go 项目的依赖管理模式。它有以下几个取值：

off：禁用 Go 模块支持。在这种模式下，Go 会使用旧的 GOPATH 模式进行依赖管理。
on：启用 Go 模块支持。在这种模式下，Go 会使用 Go 模块进行依赖管理。
auto：自动检测 Go 模块支持。Go 会根据当前目录下是否存在 go.mod 文件来决定是否启用 Go 模块支持。如果存在 go.mod 文件，则启用 Go 模块，否则使用 GOPATH 模式。

需要注意的是，在 Go 1.16 版本之后，GO111MODULE 的默认值变为 auto，这意味着如果你没有显式地设置 GO111MODULE，Go 会自动根据当前目录的情况来选择使用 Go 模块还是 GOPATH 模式。

GOARCH

GOARCH 用于指定目标平台的体系结构（Architecture）。它决定了编译生成的二进制文件所针对的处理器架构。

常见的 GOARCH 值包括：

386：表示 32 位 x86 处理器架构。
amd64：表示 64 位 x86-64 处理器架构，也称为 Intel 64 或 AMD64。
arm：表示 ARM 处理器架构（32 位）。
arm64：表示 ARM 处理器架构（64 位）。
ppc64：表示 64 位 PowerPC 处理器架构。
ppc64le：表示 64 位 Little-Endian PowerPC 处理器架构。
mips：表示 MIPS 处理器架构。
mipsle：表示 Little-Endian MIPS 处理器架构。
mips64：表示 64 位 MIPS 处理器架构。
mips64le：表示 64 位 Little-Endian MIPS 处理器架构。
s390x：表示 IBM System z 处理器架构。

根据不同的目标平台，你可以设置不同的 GOARCH 值来编译适配的二进制文件。例如，如果要编译针对 64 位 x86 架构的二进制文件，可以将 GOARCH 设置为 amd64

GOCACHE

GOCACHE 是 Go 编译器的缓存目录，用于存储编译过程中生成的对象文件、依赖关系和编译缓存等。它是一个环境变量，用来控制 Go 编译器的缓存行为。

在 Go 编译过程中，编译器会生成和使用各种临时文件和中间文件。这些文件可以存储在 GOCACHE 目录下，以便在后续的编译过程中重用。这样可以提高编译速度，减少重复工作。

GOCACHE 的默认值是 ~/.cache/go-build（在 Linux 和 macOS 系统上）。你可以通过设置 GOCACHE 环境变量来改变默认的缓存目录。

需要注意的是，GOCACHE 环境变量只影响编译器的缓存行为，对于运行时的缓存（如包的导入和编译后的可执行文件等），它没有影响。

GOEXPERIMENT

GOEXPERIMENT 用于启用或禁用 Go 编译器的实验性特性。

Go 语言的发展和改进是一个持续的过程，为了测试和引入新的特性，Go 团队会在每个版本中引入一些实验性的功能。这些功能可能还不够稳定或完善，因此默认情况下是禁用的。通过设置 GOEXPERIMENT 环境变量，你可以选择启用这些实验性特性。

GOEXPERIMENT 环境变量的值是一个逗号分隔的列表，每个值代表一个实验性特性。下面是一些常见的实验性特性和它们的值：

fieldtrack：启用结构体字段跟踪。这个特性可以用于调试和优化，它会在运行时记录结构体字段的位置信息。
preemptibleloops：启用可抢占的循环。这个特性可以在循环中进行调度，以提高并发性能。
staticlockranking：启用静态锁排序。这个特性可以改进锁的性能，尤其是在大型并发程序中。

需要注意的是，实验性特性可能会在不同版本的 Go 中有所变化或删除，因此在生产环境中使用时需要谨慎。此外，不同的实验性特性可能会对程序的性能、稳定性或可移植性产生影响，因此在使用时应进行充分的测试和评估。

GOPRIVATE

GOPRIVATE 是一个环境变量，用于指定私有模块的访问权限。在 Go 模块化开发中，模块可以分为两种类型：公共模块和私有模块。

GOPRIVATE 的作用是告诉 Go 工具链哪些模块是私有模块，需要使用私有仓库进行下载和更新，而不是默认的公共模块代理。

具体来说，GOPRIVATE 变量定义了一组以逗号分隔的模式，用于匹配私有模块的导入路径。当你使用 go get、go build、go run 等命令下载或更新依赖时，Go 工具链会检查导入路径是否与 GOPRIVATE 中的模式匹配，如果匹配，则会使用私有仓库进行操作。

使用 GOPRIVATE 可以确保私有模块的访问权限，并防止将私有代码意外地发布到公共模块代理中。

注意事项：

GOPRIVATE 只影响使用 Go 工具链操作的模块，不影响手动下载和引用的模块。
GOPRIVATE 只适用于 Go 版本 1.13 及以上。
如果你使用 Go Modules（Go 1.11+），并且有私有模块需要下载，建议设置 GOPRIVATE 来确保私有模块的访问权限。

使用 GOPRIVATE 可以更好地管理和保护私有模块的访问权限，确保项目中的私有代码得到合适的保护和控制。

GOPROXY

GOPROXY 是一个环境变量，用于设置 Go 模块的代理服务器。Go 模块是 Go 1.11 及以上版本引入的一种模块化管理依赖的方式。

在 Go 模块化开发中，GOPROXY 可以指定用于下载和更新依赖模块的代理服务器地址。默认情况下，Go 工具链会使用 https://proxy.golang.org 作为公共模块代理。

通过设置 GOPROXY，可以使用自定义的代理服务器，例如私有代理或内部镜像，来加速依赖的下载和更新。这对于在某些网络环境下访问公共代理存在限制或需要访问自定义的模块代理非常有用。

GOPROXY="https://goproxy.cn,direct"

GOROOT

GOROOT 是指定 Go 的安装路径。它指向 Go 语言的安装根目录，其中包含了 Go 的标准库、工具链和其他相关文件。GOROOT 变量通常在安装 Go 时自动设置，指向 Go 的安装路径。

GOPATH

GOPATH 是指定 Go 工作区的根目录。它用于指定包的导入路径和存放项目源代码、依赖包和构建输出的位置。在 GOPATH 下，按照约定的目录结构组织代码，例如 src 子目录用于存放源代码，pkg 子目录用于存放编译后的包对象，bin 子目录用于存放可执行文件。

GOBIN

GOBIN 是一个环境变量，用于指定 Go 可执行文件的安装路径。它指定了 Go 命令（如 go build、go install）构建的可执行文件应该被安装到哪个目录中。

默认情况下，如果没有设置 GOBIN 环境变量，Go 命令会将可执行文件安装到 GOPATH/bin 目录下（在 Go 1.16 及之前的版本中，默认是 GOPATH/bin，在 Go 1.17 及以后的版本中，默认是 $(go env GOCACHE)/bin）。

GOMODCACHE

GOMODCACHE 是一个环境变量，用于指定 Go 模块缓存的路径。在使用 Go 模块管理依赖时，下载的模块文件会被缓存到 GOMODCACHE 目录下，以便在后续的构建过程中重复使用，从而提高构建速度。

默认情况下，如果没有设置 GOMODCACHE 环境变量，Go 会将模块缓存存储在 $GOPATH/pkg/mod 目录下（在 Go 1.16 及之前的版本中，默认是 $GOPATH/pkg/mod，在 Go 1.17 及以后的版本中，默认是 $GOCACHE/mod）。

GOFLAGS

GOFLAGS 是一个环境变量，用于设置 Go 命令的额外标志。通过设置 GOFLAGS 环境变量，你可以在运行任何 Go 命令时指定一些额外的标志参数。

GOFLAGS 的值应该是一个字符串，其中包含要传递给 Go 命令的额外标志。多个标志之间可以使用空格或逗号进行分隔。

例如，你可以将 GOFLAGS 设置为 -mod=vendor -race，这样在运行 go build 或 go test 命令时就会自动应用这些标志。这在需要频繁使用相同的标志时很有用，可以避免每次都手动输入相同的标志。

需要注意的是，GOFLAGS 只影响通过命令行直接运行的 Go 命令，对于使用 go build、go test 等命令的子命令或脚本可能不起作用。