Go 1.16+ 默认启用 Modules，GOPATH 非必需但部分命令（如 go install、go get 非模块模式）仍依赖它；需确保 GO111MODULE=on、GOPROXY 可用，并避免项目路径与 module 声明不一致导致“找不到包”。
Go 语言环境搭建本身不难，但容易卡在 GOPATH、GOBIN、模块模式与 GOPROXY 的组合配置上——尤其是当你刚从其他语言转过来，或想在多项目间隔离依赖时。
确认系统是否已安装 Go 及其版本是否可用
别直接下载安装包就以为完事了。很多用户装完发现 go version 报错或显示旧版本，本质是 PATH 没生效，或系统残留了旧版二进制。
- 终端执行
which go看路径，再用ls -l $(which go)确认指向的是你刚装的版本 - 检查
go env GOROOT是否指向正确的安装目录（比如/usr/local/go），不是$HOME/sdk/go1.x这类手动解压路径（除非你真这么管） - 如果
go version显示command not found，重点查 shell 配置文件（~/.zshrc或~/.bash_profile）里是否漏加了export PATH=$PATH:/usr/local/go/bin
启用 Go Modules 并设置可信代理
Go 1.16+ 默认开启模块模式，但若本地有 GO111MODULE=off 环境变量或项目根目录下存在 vendor/ 目录，go get 仍会退回到 GOPATH 模式，导致依赖混乱。
- 全局启用：运行
go env -w GO111MODULE=on - 国内必须设代理，否则
go get卡住或报timeout：执行go env -w GOPROXY=https://proxy.golang.org,direct（推荐加direct回退机制） - 如公司内网需走私有代理，可替换为
https://goproxy.your-company.com，但务必确认该服务支持/@v/list和/@v/vX.Y.Z.info接口
避免 GOPATH 误用带来的“找不到包”问题
即便启用了 Modules，某些老教程或 IDE（如旧版 Goland）仍默认读取 GOPATH 来索引代码，导致 go run 成功但编辑器标红，或 go list ./... 扫不到子包。
立即学习“go语言免费学习笔记（深入）”；
- 不再需要把项目放
$GOPATH/src下——新建任意目录，go mod init myapp即可开始 - 如果仍要兼容旧工具链，可显式清理：
go env -u GOPATH（清空）或go env -w GOPATH=$HOME/go（设为固定值，避免随 shell 变化） - 注意
go build时若提示cannot find module providing package ...，大概率是当前目录没go.mod，或go.mod里module声明名和 import 路径不一致
真正麻烦的不是装 Go，而是不同项目对 GOOS/GOARCH、GOCACHE、甚至 CGO_ENABLED 的隐式依赖；这些参数一旦混用，交叉编译失败或 cgo 包链接报错，排查起来比重装还费时间。
