Go SDK离线安装需三步：下载匹配系统/架构/版本的压缩包，解压至固定路径（如Linux/macOS的/usr/local/go），并配置PATH；第三方模块需复制有网机器生成的pkg/mod完整目录结构到离线机GOPATH对应位置，并确保go.mod与go.sum齐全；交叉编译和cgo需额外工具链，纯Go跨平台编译才安全。
Go SDK 怎么手动下载安装（不走官网 installer）
离线环境里，go install 或双击安装包根本跑不起来，得靠压缩包+解压+配 PATH。核心就三步：找对版本、解压到固定位置、让终端认得到 go 命令。
常见错误是下错架构（比如在 ARM64 机器上扔了个 amd64 包），或者解压后没把 bin 目录加进 PATH，导致敲 go version 报 command not found。
- 去 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 手动选包：看清楚系统（
linux/windows/darwin）、架构（amd64还是arm64）、版本（推荐1.21.x或1.22.xLTS 级别） - Linux/macOS 下解压到
/usr/local/go是最省事的路径，Windows 解压到C:\Go（避免空格和中文路径） - Linux/macOS 配 PATH：
export PATH=/usr/local/go/bin:$PATH，写进~/.bashrc或~/.zshrc；Windows 就改系统环境变量里的Path，加一条C:\Go\bin
离线时怎么装第三方模块（不用 go get）
没网络时 go get 必然失败，但 Go 支持直接放模块文件进本地缓存目录，让 go build 当成已下载模块用。关键不是“复制代码”，而是按 Go 的模块缓存结构来放。
容易踩的坑是只复制源码却不生成 go.mod 和 go.sum，或者路径拼错导致 go list -m all 看不见模块。
- 先在有网机器上用目标项目跑一次
go mod download，它会把所有依赖拉到$GOPATH/pkg/mod下 - 把整个
pkg/mod目录打包带走（注意保留子目录层级，比如github.com/xxx/yyy@v1.2.3这种格式不能扁平化） - 离线机上，确保
GOPATH环境变量已设（如/home/user/go），然后把包解压到对应位置：/home/user/go/pkg/mod - 如果模块是私有库或没打 tag，还得额外在离线机上运行
go mod edit -replace=example.com/foo=../local-foo指向本地路径
go build 老报 missing module，但明明文件都在
不是文件没放对，是 Go 默认启用 GOPROXY=direct 且关了校验，但它仍会查 go.sum 和模块元信息。缺 go.sum 或哈希不匹配，就会拒绝构建。
典型现象是 go build 提示 missing go.sum entry 或 checksum mismatch，尤其在拷贝模块后没同步校验文件时。
- 有网机器上，进项目目录执行
go mod tidy，它会自动生成/更新go.sum - 把整个项目目录（含
go.mod、go.sum、main.go等）一起拷到离线机，别只拷源码 - 如果必须手动生成
go.sum，可在离线机上临时开代理（如用 USB 共享手机热点），跑一次go mod download再断开 - 极端情况可绕过校验：
GOINSECURE="*" GOPROXY=direct go build，但仅限测试，别用于交付
交叉编译和 CGO 在离线环境里的雷区
想在 Linux 上编译 Windows 程序？或者用了 cgo 调 C 库？离线时这些操作会立刻暴露依赖盲区——SDK 自带的 go 工具链不包含其他平台的 sysroot，cgo 更需要本地有 gcc、头文件、静态库。
很多人以为“SDK 装好就能 crossbuild”，结果 GOOS=windows go build 卡在找不到 ld，或者 cgo 报 cannot find -lc。
- 交叉编译纯 Go 代码（无
cgo）是安全的：只要 SDK 支持目标平台（查go tool dist list），就不需要额外文件 - 一旦开了
CGO_ENABLED=1，就必须在目标平台对应的离线机上装好全套 C 工具链（如gcc-mingw-w64for Windows target on Linux） - 建议离线项目默认关
cgo：CGO_ENABLED=0 go build，除非真要调 C 函数；否则提前在有网机上编译好二进制再搬运 -
go env -w GOOS=xxx GOARCH=xxx可持久化设置，但不会自动解决 C 依赖，这点常被忽略
离线搭 Go 环境最麻烦的从来不是下载，而是模块校验、CGO 依赖、跨平台头文件这三块——它们不报错则已，一报就是找不到具体该补哪个文件。动手前先用 go env 和 go list -m all 看清当前环境到底“认为”自己有什么。
