go111module=on 可彻底隔离 gopath 干扰，确保模块模式生效；gopath 仅用于存放二进制（如 gobin=$home/go/bin）；gobin 错误会导致 go install 静默失败；goproxy 与 gosumdb 必须配套配置；go env -w 设置可能被 shell export 覆盖，需保持一致。
go env 里的 GOPATH 和 GO111MODULE 怎么一起干活
Go 1.11 引入模块（module）后，GOPATH 不再是包查找的唯一依据，但它的存在仍会干扰 go mod 行为——尤其当你在 $GOPATH/src 下执行 go build 时，Go 仍可能退化为 GOPATH 模式。
关键判断：如果 GO111MODULE=on，且当前目录有 go.mod，GOPATH 就基本不参与依赖解析；但如果 GO111MODULE=auto（默认值），且你在 $GOPATH/src 下初始化项目，Go 会忽略 go.mod，强制走 GOPATH 模式。
-
GO111MODULE=on是最稳妥的选择，能彻底隔离 GOPATH 对模块行为的干扰 - 检查是否生效：运行
go env GO111MODULE，输出必须是on，不是空或auto - 别只改当前 shell：用
go env -w GO111MODULE=on写入全局配置，否则 CI 或新终端里还会掉坑 -
GOPATH本身可以保留（比如用于go install二进制），但只要不用它存源码，就几乎不影响模块逻辑
为什么 GOBIN 设错会导致 go install 找不到命令
GOBIN 控制 go install 把编译好的可执行文件放哪。它不等于 GOPATH/bin——当 GO111MODULE=on 时，GOBIN 若为空，Go 会 fallback 到 $GOPATH/bin；但如果 GOBIN 被设成一个不存在的路径（比如 /usr/local/go/bin 但没权限），go install 会静默失败，不报错，也不生成二进制。
- 验证方式：执行
go install .后，立刻查ls -l $(go env GOBIN)，看文件是否存在 - 推荐设为
$HOME/go/bin并加入$PATH，避免权限和路径歧义 - 注意 macOS/Linux 区分大小写，Windows 下路径斜杠方向不影响，但环境变量名必须全大写
- 如果用
go install example.com/cmd/foo@latest，GOBIN错了就真找不到那个foo命令了
GOPROXY 配置不对，go mod download 就卡住或拉错包
模块下载默认走 https://proxy.golang.org，国内直连常超时或返回 403；设成私有代理或镜像（如 https://goproxy.cn）能解决，但容易漏掉 GOSUMDB=off 或 sum.golang.org 的配套调整。
立即学习“go语言免费学习笔记（深入）”；
- 必须同步配：设了
GOPROXY=https://goproxy.cn，就得设GOSUMDB=sum.golang.org+https://goproxy.cn，否则校验失败，go mod download会停在 checksum mismatch - 开发阶段可临时关校验：
go env -w GOSUMDB=off，但上线前务必关掉 - 私有模块场景下，
GOPROXY要支持direct回退，例如：GOPROXY=https://goproxy.cn,direct，不然公司内网模块拉不下来 - CI 环境里建议显式传参：
GO111MODULE=on GOPROXY=https://goproxy.cn GOSUMDB=off go mod download，避免依赖全局 env
为什么 go env -w 改了但 go build 还不认
go env -w 写的是 Go 自己的配置文件（$HOME/go/env），不是 shell 环境变量。如果 shell 里手动 export 过同名变量（比如 export GOPROXY=xxx），它会覆盖 go env -w 的设置——Go 读取顺序是：shell 变量 > go env 文件 > 默认值。
- 排查方法：运行
go env GOPROXY和echo $GOPROXY，两者输出必须一致 - 常见翻车点：在
.zshrc或.bash_profile里写了export GOPROXY=...，但后来又用go env -w改，结果 shell 的 export 一直优先生效 - 解决方案：删掉 shell 配置里的
export行，只靠go env -w管理；或者反过来，全用 shell export，别混用 -
go env -u KEY可以取消写死的值，恢复为未设置状态，比删文件安全
模块路径解析、代理校验、环境变量覆盖——这些都不是孤立参数，而是一组咬合的齿轮。少对准一颗，go build 就可能在你想不到的地方转不动。
