推荐使用官方二进制包安装Go，避免apt/yum等系统包管理器导致版本滞后、路径不标准及环境变量冲突；需下载匹配架构的tar.gz包解压至/usr/local，正确配置GOROOT、GOPATH和PATH，并用go env -w设置GOPROXY、GOSUMDB等关键变量以保障模块下载与校验稳定。
直接用官方二进制包，别碰系统包管理器
Ubuntu 的 apt install golang、CentOS 的 yum install golang 通常版本滞后（比如只到 go1.19），且安装路径不标准（/usr/lib/go 而非 /usr/local/go），会导致 go env GOROOT 读错、go mod 行为异常，甚至 go build 找不到内置工具链。
正确做法是去 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载与目标机器完全匹配的 go$VERSION.$OS-$ARCH.tar.gz（例如 go1.22.5.linux-amd64.tar.gz 或 go1.22.5.darwin-arm64.tar.gz）：
- 先运行
uname -m确认架构（x86_64→amd64，aarch64→arm64） - 解压到
/usr/local：sudo tar -C /usr/local -xzf go1.22.5.linux-amd64.tar.gz - 验证：
/usr/local/go/bin/go version必须能直接执行并输出版本
GOPROXY 必须设成多源 fallback，不能只写一个地址
受限网络下，单个镜像源（如只设 https://goproxy.cn）一旦不可用，go mod download 就会卡死或报 Get "https://goproxy.cn/...": dial tcp: i/o timeout。国内推荐组合：
go env -w GOPROXY="https://goproxy.cn,https://mirrors.tuna.tsinghua.edu.cn/goproxy/,direct"-
direct是必须项：它让私有模块（如git.internal.company/project）跳过代理，避免认证失败 - 不要用
export GOPROXY=...写 shell 配置——那是会话级的，CI、systemd、IDE 终端可能不继承；用go env -w写入用户级配置更稳
GOSUMDB=off 只能临时关，生产环境要换可信校验源
受限网络常导致 verifying github.com/xxx@v1.2.3: checksum mismatch 或 x509: certificate has expired（时间不同步也会触发）。这不是模块本身问题，而是 Go 默认连 sum.golang.org 校验失败。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 调试阶段可临时禁用：
go env -w GOSUMDB=off - 但上线前必须恢复，并改用国内可信校验源：
go env -w GOSUMDB=sum.golang.google.cn - 如果公司有私有校验服务，应设为
GOSUMDB=your-sum-server.example.com - 注意：
GOSUMDB=off不等于跳过校验——它只是不联网查，仍会用本地go.sum文件比对，所以go.sum本身必须干净（没被手动改过）
离线预拉依赖时，go mod download -x 比 vendor 更可靠
go mod vendor 看似“一键离线”，但它不处理 replace 到本地路径的模块，也不保证间接依赖（// indirect）全量落盘，构建时仍可能报 no required module provides package。
- 在联网机器上，用**同版本 Go** 执行：
go mod download -x golang.org/x/net golang.org/x/sys ...（列出所有显式依赖） - 加
-x参数能看清实际下载路径，确认它们都进了$GOPATH/pkg/mod/cache/download/ - 把整个
$GOPATH/pkg/mod目录打包带走，离线机上设GOPROXY=file:///path/to/mod/cache（需用goproxy工具起本地服务）或直接go env -w GOPROXY=direct+GOSUMDB=off - 关键点：离线机上的 Go 版本、
GOOS/GOARCH必须和预拉机器一致，否则go.sum哈希不匹配
真正麻烦的不是下载慢，而是校验链断裂和模块路径污染——尤其当项目里混了 replace、私有域名、go.work 多模块结构时，一个配置错位就全盘失效。
