GOROOT和GOBIN必须显式设置并加入PATH，否则go install生成的二进制无法调用；GO111MODULE必须设为on，避免模块模式退化；GOPROXY需配置为https://goproxy.cn,direct以支持私有仓库。
GOROOT 和 GOBIN 必须显式设置，不能依赖默认路径
很多新手以为装完 Go 就能直接用，结果 go install 生成的二进制找不到，或者 gofmt 在 IDE 里报“command not found”。根本原因是 GOBIN 没设，或没加进 PATH。
Linux/macOS 下推荐统一设为 $GOROOT/bin，Windows 下是 %GOROOT%in。别让 GOBIN 空着，也别设成 $HOME/go/bin 这类容易和 GOPATH 混淆的路径。
-
GOROOT必须指向真实安装目录（如/usr/local/go或C:Go），不能留空或指向软链接顶层 -
GOBIN设好后，务必把它的值加进PATH，否则go命令本身可能都调不到（尤其在 CI 环境里） - 验证方式不是只看
echo $GOROOT，而是执行which go（macOS/Linux）或where go（Windows），输出必须包含GOBIN路径
GO111MODULE 必须设为 on，避免 GOPATH 模式干扰
设成 auto 看似省事，实际会导致项目在无 go.mod 时悄悄退回到 GOPATH 模式，go list -m all 报错、依赖解析错乱、甚至 go run 找不到本地包。
直接设为 on 后，所有操作强制走模块模式，go mod init 成为第一步，go get 不再影响 GOPATH/src，行为可预测。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 用
go env -w GO111MODULE=on全局生效，比写 shell 配置更可靠（尤其在 Docker 构建或 CI 中） -
GOPATH在模块模式下已非必需，但若保留，建议设为独立路径（如$HOME/go），不与项目目录混用 - IDE 调试时，需确认 Debug 控制台里
go env GO111MODULE输出是on，否则断点可能加载错源码
国内开发必须配 GOPROXY，且要带 direct 回退
不设代理时，go mod download 卡住或超时是常态，错误信息常是 no required module provides package，其实只是拉不到依赖。
正确配置是带 ,direct 后缀，确保私有仓库或内部模块不被代理劫持：
go env -w GOPROXY=https://goproxy.cn,direct
- 不要只写
https://goproxy.cn—— 缺少,direct会导致私有 Git 地址（如git.internal.com/repo）也被转发到代理，返回 404 - 企业内网可加
GOPRIVATE：例如go env -w GOPRIVATE=git.internal.com,github.com/myorg - 验证是否生效：删掉
go/pkg/mod/cache后运行go mod download，观察是否秒级完成，而非卡在 “Fetching”
IDE 环境变量继承不可信，必须显式覆盖
VS Code 点图标启动、Goland 双击打开，往往读不到 shell 的 .zshrc 或 profile，导致 GOROOT 为空、go version 报错、调试器找不到 SDK。
解决方式不是“重启 IDE”，而是绕过继承逻辑，直给路径：
- VS Code：在工作区
.vscode/settings.json里加"go.goroot": "/usr/local/go"（macOS/Linux）或"go.goroot": "C:\Go"（Windows） - Goland：Settings → Go → GOROOT，手动填绝对路径，别选“Auto-detect”
- 关键验证点：打开 Debug 控制台，执行
go env GOROOT，输出必须和设置一致；go env GOPROXY也得对得上
环境变量不是设一次就一劳永逸的事——它在 shell、IDE、CI、容器里各走各的路。最稳的做法，是每个执行上下文都独立确认、独立覆盖，而不是指望某处“自动继承”。
