应优先使用 golang.org/dl 下载指定 Go 版本二进制到用户目录，显式设置 GOROOT、GOBIN 和 GOPROXY 等环境变量，避免系统包管理器安装的旧版和路径混乱问题。
直接用 golang.org/dl 下载对应版本二进制，不装系统包管理器
很多新手在新电脑上第一反应是 brew install go（macOS）或 apt install golang（Ubuntu），但这样装的往往是系统仓库里陈旧的 LTS 版本，比如 Ubuntu 22.04 默认是 go1.18，而当前稳定版已是 go1.22。更关键的是，系统包管理器装的 GOROOT 路径不统一、升级困难、卸载残留多。
Go 官方从 go1.17 起内置了 golang.org/dl 工具，能直接下载任意官方发布版的二进制并安装到用户目录，完全绕过系统包管理器：
go install golang.org/dl/go1.22.5@latest go1.22.5 download
执行后会在 $HOME/sdk/go1.22.5 下解压完整 Go 环境，之后就能用 go1.22.5 命令切换使用。这种方式干净、可复现、无权限问题。
GOROOT 和 GOBIN 必须显式设为用户路径，别碰系统级目录
默认情况下，go install 生成的可执行文件会放进 $HOME/go/bin，但这个路径和 GOROOT 是两回事。常见错误是把 GOROOT 指向 /usr/local/go（系统安装路径）或让其为空（依赖默认探测），结果导致 go version 显示对，但 go build -buildmode=plugin 失败，或 go test -race 报找不到 runtime 包 —— 因为探测逻辑会错配标准库路径。
立即学习“go语言免费学习笔记（深入）”；
正确做法是在 shell 配置中明确声明：
-
GOROOT=$HOME/sdk/go1.22.5（指向golang.org/dl下载解压后的根目录） -
GOBIN=$HOME/go/bin（保持默认也行，但显式声明更可控） -
PATH=$GOBIN:$GOROOT/bin:$PATH（注意顺序：$GOBIN在前，确保本地工具优先）
验证方式：
go env GOROOT GOBIN which go输出的
GOROOT 必须是你设的路径，which go 必须指向 $GOROOT/bin/go，不是 /usr/bin/go 或其他。
初始化 go mod 项目时跳过代理设置也能跑，但国内必须配 GOPROXY
新环境首次 go mod init + go run 很可能卡在 Fetching https://proxy.golang.org/... 或直接超时失败，尤其在国内。这不是网络问题，而是 Go 默认启用了模块代理，但没设镜像源。
别用 go env -w GOPROXY=direct 关闭代理——这会让所有依赖直连 github.com，99% 情况下失败。正确做法是设国内可信镜像：
go env -w GOPROXY=https://goproxy.cn,direct go env -w GOSUMDB=sum.golang.org
注意两点：
-
goproxy.cn是七牛维护的公开镜像，同步及时，支持校验；direct是 fallback，仅当镜像不可用时才直连 -
GOSUMDB不能关（即不能设成off），否则go get会拒绝校验失败的模块，报checksum mismatch
如果公司内网有私有代理，替换 https://goproxy.cn 为对应地址即可，其余逻辑不变。
别漏掉 GO111MODULE 和 GOPATH 的现代取值
Go 1.16+ 默认开启模块模式，但某些老脚本或 CI 配置仍会检查 GO111MODULE。不显式设它，偶尔在非 go.mod 目录下执行 go list 会意外进入 GOPATH 模式，导致依赖解析异常。
建议统一设为：
-
GO111MODULE=on（强制模块模式，无视当前路径有没有go.mod） -
GOPATH=$HOME/go（仍需保留，因为go install、go test -coverprofile等仍用它存缓存和输出）
虽然 go mod 不再依赖 GOROOT/src 下的 vendor，但 go build -mod=vendor 仍会读 $GOPATH/src（如果存在），所以 GOROOT 和 GOPATH 必须分离，且 GOROOT 不能等于 GOPATH。
最易忽略的一点：Windows 用户要注意路径分隔符。PowerShell 中设环境变量必须用 $env:GOROOT="C:\Users\me\sdk\go1.22.5"，而不是 Unix 风格斜杠；否则 go env 显示正常，但 go run 会静默失败。
