必须设置 GOROOT、GOBIN 和 PATH；GOROOT 指向 Go 安装根目录，GOBIN 设为 $GOROOT/bin 并加入 PATH；GO111MODULE 推荐设为 on；GOPATH 在模块模式下非必需但旧项目仍需；IDE 需确保继承 shell 环境或手动配置。
Go 环境变量必须设哪些才能正常运行
不设好 GOROOT、GOBIN 和 PATH，go 命令大概率报错或找不到工具。默认安装下 GOROOT 是 Go 安装根目录（如 /usr/local/go 或 C:\Go），GOBIN 推荐显式设为 $GOROOT/bin（Linux/macOS）或 %GOROOT%\bin（Windows），再把 $GOBIN 加进 PATH——否则 go install 生成的二进制找不到。
-
GOPATH在 Go 1.16+ 已非必需（模块模式默认启用），但若用旧项目或go get无go.mod，仍需设置，建议指向独立路径如~/go -
GO111MODULE推荐设为on，避免意外进入 GOPATH 模式导致依赖解析异常 - Windows 用户注意：环境变量名大小写不敏感，但脚本中引用时保持
%GOROOT%这种写法更稳妥
验证 Go 环境变量是否生效
别只看 echo $GOROOT，要实际验证命令链是否通。在终端执行：
go env GOROOT GOBIN GOPATH GO111MODULE
输出应全非空且路径存在。再试：
which go # Linux/macOS where go # Windows
结果必须指向 $GOBIN/go。如果 go version 报 “command not found”，说明 PATH 没包含 $GOBIN；如果 go list -m all 报 “not in a module” 却又没 go.mod，很可能是 GO111MODULE=auto 下误入 GOPATH 模式。
立即学习“go语言免费学习笔记（深入）”；
在 IDE（VS Code / Goland）里环境变量不生效怎么办
IDE 启动方式影响环境变量继承：桌面图标启动的 VS Code 通常不读 shell 的 .zshrc 或 .bash_profile，导致 GOROOT 等为空。解决方法：
- macOS：从终端用
code .启动 VS Code，确保继承当前 shell 环境 - Windows：用“以管理员身份运行”终端再启动 Goland，或在 Goland 设置里手动填
GOROOT路径（File → Settings → Go → GOROOT） - 通用：在 VS Code 的
.vscode/settings.json中加："go.goroot": "/usr/local/go"
（路径按实际改）
注意：IDE 内置终端和调试器可能用不同环境，调试前务必点开 Debug 控制台，执行 go env 确认。
调试时发现 go build 找不到 cgo 依赖
这不是 Go 环境变量问题，而是系统级 C 工具链缺失。cgo 默认开启，一旦代码含 #include 或 import "C"，就会触发。常见现象是 exec: "gcc": executable file not found in $PATH。
- Linux：装
build-essential（Debian/Ubuntu）或gcc（CentOS/RHEL） - macOS：装 Xcode Command Line Tools：
xcode-select --install - Windows：用 TDM-GCC 或 MinGW-w64，并把
gcc所在目录加入PATH - 不想用 cgo？临时禁用：
CGO_ENABLED=0 go build，但会丢失部分标准库功能（如 DNS 解析走系统库）
真正容易被忽略的是：某些 CI 环境（如 GitHub Actions 的 ubuntu-latest）默认不带 gcc，必须显式 apt-get install -y gcc，光配 Go 环境变量没用。
