GOROOT必须指向Go工具链真实安装路径，设错会导致编译失败；GOPATH在模块时代仅控制install输出和旧工具行为，推荐默认值；GOBIN和PATH需配合确保命令可用；始终用go env验证而非凭经验猜测。
GOROOT 必须指向 Go 工具链真实安装路径
GOROOT 不是你“想放哪就放哪”的变量，它是 Go 编译器定位 fmt、net/http 等标准库的唯一依据。设错会导致 go build 直接报错：cannot find package "fmt" 或更隐蔽的 failed to load export data。
- Windows 默认安装路径是
C:\Go（MSI 安装器通常自动设置），若你改到了D:\golang，就必须手动新建系统变量GOROOT并设为该值 - Linux/macOS 若用
tar.gz解压安装，常见路径是/usr/local/go；用 Homebrew 安装则可能是/opt/homebrew/Cellar/go/1.22.0/libexec—— 此时go env GOROOT的输出才是真实值，别凭经验硬写 -
绝对不要把 GOROOT 设成 GOPATH 的子目录，例如
GOPATH=/home/user/go时，GOROOT=/home/user/go/sdk会引发工具链混乱，go install可能静默失败
GOPATH 在 Go Modules 时代只需保证 bin 可用
Go 1.11+ 启用模块后，go mod 不再读取 GOPATH/src 来找依赖，但 GOPATH 仍控制两件事：一是 go install 输出二进制的位置，二是部分旧工具（如 golint、swag）的默认行为。不设或设错，你会遇到 command not found。
- 推荐沿用默认值：
$HOME/go（Linux/macOS）或%USERPROFILE%\go（Windows），无需刻意修改 - 如果自定义了
GOPATH（比如/data/gopath），必须确保$GOPATH/bin（或%GOPATH%\bin）已加入PATH，否则go install github.com/swaggo/swag/cmd/swag装完也运行不了 - 不必再严格维护
GOPATH/src/github.com/xxx/yyy这种结构来放项目 —— 新项目直接mkdir myapp && cd myapp && go mod init myapp即可
GOBIN 和 PATH 配合才能让命令真正“可用”
很多人设了 GOPATH 却忘了加 PATH，结果 go install 成功但敲命令报错。关键不是“有没有”，而是“能不能被 shell 找到”。
Docker Hub
下载
Docker Hub (hub.docker.com)。此技能适用于所有 Docker Hub 操作，包括读取、创建、更新和删除数据。只要任务涉及 Docker Hub，就使用此技能。
-
GOBIN是可选变量；若未设置，go install默认输出到$GOPATH/bin；若设置了（如GOBIN=$HOME/bin），则所有go install结果都去那里 —— 且GOBIN不能是GOROOT下的路径 -
PATH中必须包含$GOROOT/bin（让go、gofmt可执行）和$GOBIN或$GOPATH/bin（让swag、dlv等工具可用） - 验证方法：终端里运行
go env GOROOT GOPATH GOBIN PATH
，确认四者值合理；再执行which go
和which dlv
（Linux/macOS）或where go
（Windows），看是否返回对应bin下的路径
用 go env 检查，而不是靠记忆或文档猜
不同安装方式（MSI、pkg、tar.gz、brew、scoop）对环境变量的处理逻辑不同，文档写的“默认值”可能和你机器上实际值不一致。最可靠的方式永远是让 Go 自己说话。
立即学习“go语言免费学习笔记（深入）”；
- 运行
go env
，重点关注输出中的GOROOT、GOPATH、GOBIN、GOMODCACHE和GOCACHE - 如果发现
GOROOT是空的，说明 Go 无法自检安装位置 —— 很可能PATH没包含GOROOT/bin，或者安装不完整 - 如果
GOPATH显示的是/tmp/xxx或明显异常路径，大概率是某个脚本或 IDE 临时覆盖了它，需检查 shell 配置文件（~/.zshrc、~/.bash_profile、Windows 系统变量）中是否有错误的export GOPATH=...
gvm、asdf）、WSL、Docker 或远程开发场景下，GOROOT 和 GOPATH 的实际值可能每开一个终端都不一样 —— 养成每次怀疑环境问题时先敲 go env 的习惯，比反复重装 Go 有效得多。 
