必须设置 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 模式。