Go环境搭建关键在于初始化精准：需确认go version匹配go.mod声明、GOROOT由安装自动设置、GOPROXY与GOSUMDB配对启用（如GOPROXY=https://goproxy.cn,direct且GOSUMDB=off），并确保GO111MODULE开启及项目根目录含go.mod。
Go 语言环境搭建本身不难，但后续所有项目依赖、模块导入、交叉编译和 CI 集成出问题，八成根子在初始化这一步没踩稳。
确认系统已安装 go 且版本符合项目要求
很多团队卡在 go mod download 失败或 go build 报 undefined: xxx，其实是本地 go version 低于项目 go.mod 声明的 go 1.21 —— Go 不向下兼容 minor 版本的语法和工具链行为。
- 运行
go version查看实际版本，不是看包管理器里装的“最新版” - 用
go env GOROOT确认当前生效的是哪个安装路径，避免多版本共存时被/usr/local/bin/go覆盖 - 项目级版本锁定靠
go.mod第一行go 1.21，但本地必须先装对应版本；推荐用gvm或手动解压二进制到$HOME/sdk/go1.21.0后软链~/go
GOROOT 和 GOBIN 别乱设，优先信任默认值
新手常为“统一管理”手动设置 GOROOT，结果导致 go install 编译的二进制找不到标准库，或 go test 因 CGO_ENABLED=0 下缺失 net 包而失败。
-
GOROOT应只由安装过程自动设定；除非你从源码编译 Go，否则不要 export 它 -
GOBIN默认是$GOPATH/bin，而$GOPATH默认是$HOME/go；若改了GOBIN，记得把新路径加进$PATH，否则go install出的命令找不到 - 验证方式：执行
go env GOROOT GOBIN GOPATH，三者应互不重叠，且GOROOT指向 SDK 根目录（含src、bin），GOPATH是工作区根目录（含src、bin、pkg）
模块代理和校验和要配对启用，否则 go mod tidy 会静默失败
国内直连 proxy.golang.org 经常超时或返回 403，但只配 GOPROXY=https://goproxy.cn 不够——如果没同步关掉校验和检查，go 仍会尝试从原始仓库拉 sum.golang.org 的校验数据，最终卡死在 “verifying …”。
立即学习“go语言免费学习笔记（深入）”；
- 必须同时设置：
GOPROXY=https://goproxy.cn,direct和GOSUMDB=off（开发机）或GOSUMDB=sum.golang.org+https://goproxy.cn/sumdb/sum.golang.org（CI） -
direct表示当代理不可用时回退到直接拉源码，避免完全断网就无法构建 - 检查是否生效：运行
go env GOPROXY GOSUMDB，再执行一次go mod tidy -v，看到大量fetching日志而非长时间等待，说明代理已走通
真正麻烦的不是装不上 Go，而是 go run 能跑通、go build -o bin/app 却报 cannot find module providing package —— 这种错往往源于 GO111MODULE 状态和当前目录下是否有 go.mod 的微妙组合，得盯住 go env GO111MODULE 和 pwd 两个变量才定位得准。
