Go环境搭建需正确配置GOROOT、GOBIN、GOPROXY、GO111MODULE四变量：GO111MODULE=on启用模块系统；GOPROXY设为https://goproxy.cn,direct保障依赖拉取；GOBIN明确路径并加入PATH；GOSUMDB保持默认配合代理确保校验安全。
Go 环境搭建不是“装完 go version 能跑就算完事”的事——GOROOT、GOBIN、GOPROXY、GO111MODULE 这四个变量没配对，后续 go mod 报错、依赖拉不下来、go install 生成的二进制找不到，全是迟早要踩的坑。
go version 能跑 ≠ 环境就 ready
很多开发者执行 go version 成功后就以为万事大吉，结果一跑 go mod init 就卡住，或 go run 提示 cannot find module providing package。根本原因不是 Go 没装好，而是模块系统没真正启用。
-
GO111MODULE=on必须显式开启（Go 1.16+ 默认 on，但某些旧 shell 或 CI 环境仍可能 fallback 到 auto） -
go env -w GO111MODULE=on是最稳妥的写法，避免依赖 shell 启动时的隐式判断 - 如果项目目录下已有
go.mod，但go list -m报错，大概率是当前 shell 的GO111MODULE实际值为auto且不在 GOPATH 下 —— 此时go mod命令会静默失效
GOPROXY 必须配，尤其在国内
不设 GOPROXY，go get 或 go mod tidy 会直连 proxy.golang.org 和 sum.golang.org，超时、403、校验失败是常态，不是网络问题，是策略性拦截。
- 推荐组合：
go env -w GOPROXY=https://goproxy.cn,direct（国内稳定）或https://proxy.golang.org,direct（海外环境） -
direct表示对私有模块（如公司内网 Git 地址）跳过代理，直接拉取；漏掉它会导致私有 repo 导入失败 - 验证是否生效：运行
go env GOPROXY，输出应为完整 URL 字符串，而非https://proxy.golang.org单一地址（那是旧写法，已不兼容多源）
GOBIN 不等于 $GOROOT/bin，别硬塞进 PATH
很多人把 $GOROOT/bin 加进 PATH 就完事，结果 go install 生成的可执行文件找不到——因为默认输出路径是 $GOBIN，而这个变量默认为空，go install 会 fallback 到 $GOPATH/bin（若 GOPATH 设了），或报错 “no install location”。
立即学习“go语言免费学习笔记（深入）”；
- 明确设置：
go env -w GOBIN=$HOME/go/bin（路径可自选，但必须存在） - 随后把该路径加进
PATH：export PATH=$HOME/go/bin:$PATH（写进~/.zshrc或~/.bashrc） - 不要复用
$GOROOT/bin：那是 Go 工具链自身命令（go、godoc）所在，和你项目go install输出的二进制是两回事 - 验证：
go install golang.org/x/tools/cmd/goimports@latest，然后直接敲goimports -h应该能运行
go mod tidy 失败？先看 GOPROXY 和 GOSUMDB
go mod tidy 卡在某个依赖、反复重试、最终报 verifying xxx@vX.Y.Z: checksum mismatch，90% 是 GOSUMDB 和 GOPROXY 配合出问题，不是代码或网络问题。
-
GOSUMDB=off是临时排障手段（仅限内网/可信环境），但生产环境绝不能关 —— 它负责校验模块完整性 - 正确做法：
go env -w GOSUMDB=sum.golang.org（默认值），配合GOPROXY使用；若用国内代理，部分镜像（如 goproxy.cn）已内置 sumdb 代理逻辑，无需额外改 GOSUMDB - 常见错误：
GOPROXY=https://goproxy.cn（缺,direct） +GOSUMDB=off→ 私有模块能拉，但校验绕过，上线后可能被篡改 - 终极验证命令：
go clean -modcache && go mod download && go mod verify，三步全过才算稳
环境变量不是设一次就高枕无忧——CI/CD 流水线、Docker 构建、远程服务器 SSH 会话，都可能加载不同的 shell 配置。每次换环境，go env 全量检查一遍比凭记忆靠谱。
