Go二进制包是官方提供的已编译.tar.gz归档包，适用于所有Linux发行版，需匹配架构（如arm64）、校验SHA256，并配合$GOROOT、$GOPATH/pkg/mod及cache/download三路径离线部署。
离线环境不能“下载”，只能提前在联网机打包好再拷贝过去——Go 二进制包和模块缓存是两套独立东西，漏掉任何一套，go build 都会卡住或报错。
怎么选对 Go 二进制包（不是 RPM，也不是源码）
官方只提供 .tar.gz 归档包，适用于所有 Linux 发行版（包括 CentOS 8/9、Rocky、AlmaLinux），不依赖系统包管理器。RPM 包虽存在，但：
- 安装后常因 --nodeps 导致 go version 显示 unknown
- GOROOT 路径被硬编码进 RPM，迁移困难
- ARM64 机器若误用 linux-amd64 包，go list -m all 会 panic，而非报错提示
正确做法：
- 去 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 找对应架构的 goX.Y.Z.linux-ARCH.tar.gz（如 go1.24.5.linux-arm64.tar.gz）
- 不要用第三方镜像站打包的“精简版”或“集成版”，它们可能删了 doc/ 或 api/ 目录，导致 godoc 或 CI 检查失败
- Windows 或 macOS 机器上下载后，用 sha256sum go1.24.5.linux-arm64.tar.gz 核对校验值（官网页面下方有）
U 盘拷贝时必须保留的三个路径
仅拷贝 go 目录不够。离线构建真正依赖的是以下三处内容，缺一不可：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
$GOROOT：即解压后的go/目录（如/usr/local/go），含bin/go、src/、pkg/ -
$GOPATH/pkg/mod：模块缓存主目录，包含所有github.com/xxx/yyy@v1.2.3的解压后代码 -
$GOPATH/pkg/mod/cache/download：原始 zip 包 +.info+.zip.hash文件，go mod download离线回退时唯一可信来源
常见错误：
- 只拷了 $GOPATH/pkg/mod，没拷 cache/download → go mod verify 失败
- 把 $GOPATH 设成 /home/user/go，但 U 盘里存的是 /root/go → 解压后路径不匹配，go env GOPATH 输出为空
- 用 Windows 资源管理器直接拖拽，隐藏文件（如 .git 或权限位）丢失 → Linux 上解压后 go 命令无执行权限
离线机上环境变量怎么设才真正生效
临时 export 或写进 ~/.bashrc 不够。很多场景根本读不到这些变量：
- systemd 服务启动的 Go 程序 → 只读
/etc/environment和/etc/profile.d/ - VS Code 集成终端 → 默认不 source
~/.bashrc，除非显式配置 - CI 脚本（如 Jenkins）→ 启动的是非交互式 shell，跳过
~/.bashrc
安全写法：
- 创建 /etc/profile.d/golang.sh，内容为：
export GOROOT=/usr/local/go<br>export GOPATH=/home/app/go<br>export PATH=$GOROOT/bin:$GOPATH/bin:$PATH<br>go env -w GOPROXY=direct<br>go env -w GOSUMDB=off
- 运行
source /etc/profile.d/golang.sh，然后新开终端验证：go env GOROOT GOPATH GOPROXY GOSUMDB 输出应全为预期值，不能是空或默认地址
验证离线可用性的最小检查清单
别等 go build 报错才排查。拷完、设完后立刻跑这三步：
-
go version→ 必须输出类似go version go1.24.5 linux/arm64，不能是unknown -
go env GOPROXY GOSUMDB→ 必须是direct和off，不是空字符串、不是off拼错、更不是https://... -
cd /path/to/your/project && go list -m all | head -5→ 应快速列出模块，不卡顿、不报proxy.golang.org: no such host
最后一句提醒：如果项目用了 replace 指向私有 Git 地址（如 replace example.com/lib => git.internal.example.com/lib v1.0.0），go mod download 根本不会拉取它——你得手动 git clone 那个仓库，放到 ./vendor/ 或 ./internal/ 下，并用 go mod edit -replace=example.com/lib=./internal/lib 改写本地路径。这事没法自动化，必须人眼核对。
