GOPATH是Go工具链共享的工作区根目录，必须包含src/pkg/bin子目录以满足硬编码路径约定；多路径用冒号分隔，GOBIN优先级高于GOPATH/bin；现代模块项目虽弱化其作用，但go get无go.mod、go install及部分旧工具仍强依赖它。
GOPATH 是 Go 工具链用来定位源码、编译产物和可执行文件的根目录，不是“每个项目一个”，而是“所有项目共享一个（或多个）工作区”。 它在 Go Modules 普及后重要性下降，但仍未被废弃——go get（无 go.mod 时）、go install、以及大量遗留脚本仍强依赖它。设错或没设，立刻报错：cannot download, $GOPATH not set。
为什么 GOPATH 必须包含 src/pkg/bin 三个子目录
Go 工具链硬编码了这套结构，不按约定放，命令就“找不到路”：
-
src：所有源码必须放这里，且路径要匹配导入路径。比如你go get github.com/spf13/cobra，实际下载到$GOPATH/src/github.com/spf13/cobra；你自己写个包mytool/cmd，就得放在$GOPATH/src/mytool/cmd，否则import "mytool/cmd"会失败。 -
pkg：存编译好的.a包文件（如linux_amd64/github.com/spf13/cobra.a）。这是缓存，加速重复构建；删掉它只是让下次编译慢点，不会破坏功能。 -
bin：go install生成的可执行文件全扔这儿。比如go install github.com/golang/mock/mockgen后，mockgen就在$GOPATH/bin/mockgen，你得把$GOPATH/bin加进$PATH才能在终端直接敲命令。
多 GOPATH 路径怎么配？什么时候该用
你可以用冒号（Linux/macOS）或分号（Windows）拼多个路径，例如：GOPATH=$HOME/go:$HOME/work/go。Go 会从左到右查找，**第一个命中即止**——同名包在左边路径存在，右边的就彻底忽略。
- 适用场景：隔离公司内部库（
/opt/company/go）和个人实验项目（$HOME/go），避免内部包被意外覆盖。 - 风险点：路径顺序错，可能导致你改了代码却一直运行旧版本；
go list -f '{{.Dir}}' xxx可查实际加载路径，别靠猜。 - 注意：
GOBIN优先级高于$GOPATH/bin；如果设置了GOBIN，所有go install结果都去那儿，不管 GOPATH 有几个。
现代项目还用 GOPATH 吗？哪些情况绕不开
Go 1.11+ 默认启用 Modules，项目可放在任意路径，go build 不再查 GOPATH —— 但以下场景仍强制走 GOPATH：
- 执行
go get且当前目录无go.mod：工具链退化为 GOPATH 模式，必须有$GOPATH才能下载。 - 用
go install安装命令行工具（如caddy、goreleaser）：即使项目本身是 module，安装行为仍受 GOPATH 或 GOBIN 控制。 - 某些 CI/CD 脚本或老版 IDE 插件（如旧版 VS Code Go 扩展）默认读 GOPATH 查源码索引，设错会导致跳转/补全失效。
最容易被忽略的是：go env -w GOPATH=... 写入的是用户级配置，但某些容器环境或 su 切换用户后，shell 配置未重载，go env GOPATH 还显示空——务必用 go env GOPATH 实际验证，别只信 echo $GOPATH。
