go env 输出 Go 工具链当前运行时有效环境配置，影响 build、get、mod 等命令行为；包括 GOROOT（安装根目录，勿手动改）、GOPATH（模块启用后仅影响 install 路径）、GO111MODULE（推荐设为 on）、GOBIN/GOCACHE/GOMODCACHE（各司其职，勿混淆）、GOOS/GOARCH（仅编译时生效，不靠 go env -w 持久化）。
go env 命令输出的是什么
go env 显示的是 Go 工具链当前使用的环境配置，它不是读取系统 shell 环境变量的简单映射，而是 Go 安装时推导出的一组**运行时有效值**。这些值影响 go build、go get、go mod 等命令的行为，比如模块下载路径、编译目标、缓存位置等。
直接运行 go env 会输出全部键值对；加参数可查单个，例如：go env GOPATH 或 go env GOROOT。
GOROOT 和 GOPATH 的区别与设置时机
GOROOT 是 Go 标准库和工具链的安装根目录，通常由安装包自动设好，**不建议手动修改**。除非你用多版本管理（如 gvm 或手动解压多个 Go 版本），否则改它容易导致 go 命令找不到自身。
GO111MODULE 和 GOPATH 才是日常最常调整的：
立即学习“go语言免费学习笔记（深入）”；
-
GO111MODULE=on：强制启用 Go Modules，忽略GOPATH/src下的传统布局；推荐始终开启 -
GO111MODULE=off：完全禁用模块，所有依赖走GOPATH/src，已基本淘汰 -
GO111MODULE=auto（默认）：有go.mod文件才启用模块——但容易因项目位置误判，建议显式设为on -
GOPATH在启用模块后作用大幅减弱，仅影响go install生成的二进制存放位置（$GOPATH/bin），以及go get旧式用法（不带-d且无go.mod）
设置方式（以 Linux/macOS 为例）：
export GO111MODULE=on export GOPATH=$HOME/go export PATH=$PATH:$GOPATH/bin
Windows 用户请用 setx GO111MODULE on 或在 PowerShell 中用 $env:GO111MODULE="on"。
GOBIN、GOCACHE、GOMODCACHE 这几个路径怎么配不踩坑
这三个路径都指向磁盘上的具体目录，但角色不同，混淆会导致权限错误或构建失败：
-
GOBIN：指定go install编译后的可执行文件放哪，默认是$GOPATH/bin；若设了它，就别再把$GOPATH/bin加进PATH，否则可能混入旧二进制 -
GOCACHE：Go 编译缓存（.a 文件、中间对象），默认在$HOME/Library/Caches/go-build（macOS）或$HOME/.cache/go-build（Linux）；不建议改，除非磁盘空间紧张且你清楚清理逻辑 -
GOMODCACHE：模块下载缓存，默认是$GOPATH/pkg/mod；它是go mod download和go build拉依赖的地方，**不要手动删里面的内容**，应使用go clean -modcache
常见错误现象：go build 报错 cannot find module providing package xxx，往往是因为 GOMODCACHE 被误删或权限不对，而不是网络问题。
GOOS/GOARCH 如何影响交叉编译结果
GOOS 和 GOARCH 控制构建目标平台，它们只在编译时生效，不影响 go env 的“全局”显示（go env 显示的是 host 平台，即你当前机器的 GOOS/GOARCH）。
要交叉编译，必须在 go build 时显式传参：
GOOS=linux GOARCH=arm64 go build -o myapp .
注意点：
- 不能靠
go env -w GOOS=linux来持久化设置——这只会让go env GOOS返回linux，但实际编译仍按 host 平台来 - 某些组合需要额外支持，例如
GOOS=windows GOARCH=arm64在 Go 1.20+ 才稳定，旧版会报build constraints exclude all Go files - CGO_ENABLED=0 常配合交叉编译使用，避免本地 C 依赖污染目标平台
真正需要持久化的，其实是 CGO_ENABLED（设为 0 可避免 cgo 导致的动态链接问题），它可以用 go env -w CGO_ENABLED=0 写入配置文件。
环境变量一旦写入（go env -w），会保存在 $GOROOT/env 或 $GOPATH/env（取决于 Go 版本），但优先级低于命令行传入和 shell export。最容易被忽略的是：不同 shell（bash/zsh/fish）的配置文件不同，export 写错地方会导致终端里 go env 显示正常，但 IDE 或 CI 里却没生效。
