离线搭建Go环境需完整切断联网行为并提供替代路径：解压后正确配置PATH和GOROOT，设置GOPROXY=direct、GOSUMDB=off，确保go.mod中replace路径存在、vendor结构完整、cgo依赖齐备，且go.sum校验通过。
离线搭建 Go 环境不是“解压+配 PATH”就完事，缺任何一个环节都会在 go build 时突然报错，而且错误信息往往指向不存在的网络地址。核心问题在于：Go 模块系统默认联网校验、依赖解析、哈希验证三件事全关不掉，必须手动切断并提供替代路径。
go 二进制包解压后为什么 go version 报 command not found
常见错因不是没下载对包，而是 PATH 没生效或 GOROOT 冲突。尤其多用户服务器上，/usr/local/go 被其他用户改写过、或 root 安装后普通用户无读权限，都会导致命令找不到。
- 解压必须用
sudo tar -C /usr/local -xzf go1.22.3.linux-amd64.tar.gz（Linux/macOS），确保/usr/local/go/bin/go存在且可执行 - PATH 必须包含
$GOROOT/bin，不能只写/usr/local/go/bin—— 后者硬编码易出错，$GOROOT才是 Go 工具链内部识别路径的依据 - 验证方式不是只跑
go version，而是连跑两行：which go看路径，go env GOROOT看输出是否与实际解压路径一致 - 若用
go env -w GOROOT=...设置过，优先级高于 shell export，此时unset GOENV再重试，避免配置残留干扰
离线构建时提示 “unknown revision” 或 “module not found”
这不是模块没拷过来，而是 Go 仍试图联网查版本元数据或校验 sum。即使 go.mod 和 go.sum 都在，只要 GOPROXY 和 GOSUMDB 没关，构建就会卡住或失败。
- 必须在构建前设环境变量：
GOPROXY=direct GOSUMDB=off，推荐写入/etc/profile.d/golang.sh全局生效 -
go.mod中若有replace指向本地路径（如replace example.com/foo => ../foo），确保该路径真实存在且可读，否则go list -m all会直接跳过该模块 - 若用
go mod vendor，必须加-v参数运行，并检查输出里是否出现vendor/字样；没看到就说明 vendor 没被启用，此时需额外设GO111MODULE=off - 私有模块（如公司内网 Git）未打 tag 时，
go mod download会拉latest分支的 commit hash，离线机必须保证该 hash 对应的代码已放入$GOPATH/pkg/mod/cache/download/对应子目录
golang.org/x/ 等标准扩展模块为何总报 “does not contain package”
这些模块不属于 Go 主安装包，也不在 GOROOT/src 下，但很多 net/http2、crypto/boring 等底层功能强依赖它们。离线时若缺失，go build 会报错说包存在但没对应文件，本质是模块缓存结构不完整。
立即学习“go语言免费学习笔记（深入）”；
- 必须在联网机器上用目标 Go 版本执行：
go mod download golang.org/x/net golang.org/x/sys golang.org/x/text golang.org/x/exp - 打包的是整个
$GOPATH/pkg/mod目录，不是只拷golang.org子目录 —— Go 查找依赖时依赖cache/download/下的 .zip 和cache/vcs/下的 git clone 数据 - 离线机上解压后，运行
go list -m -f '{{.Dir}}' golang.org/x/net，输出路径必须指向$GOPATH/pkg/mod/golang.org/x/net@v0.28.0这类真实路径，否则就是结构没对齐 - 若项目用 cgo，还需额外确认
$GOROOT/src/runtime/cgo存在且未被裁剪 —— 某些精简版安装包会删掉这部分，导致CGO_ENABLED=1构建失败
多用户共用服务器时 GOPATH 和 GOCACHE 怎么隔离
不隔离会导致 go mod download 并发写冲突、go install 输出覆盖、甚至 go clean -cache 清掉别人正在用的缓存。这不是权限问题，而是 Go 默认复用同一路径。
- 每个用户必须设独立
GOPATH，例如export GOPATH=$HOME/go，且确保$HOME/go目录属主为当前用户、权限为755 -
GOCACHE必须避开 NFS 挂载点，设为本地路径：export GOCACHE=$HOME/.cache/go-build或/tmp/$USER/go-cache - CI/CD 脚本或定时任务启动时，必须用 login shell（如
bash -l -c "go build"），否则~/.bashrc不加载，GOPATH会 fallback 到默认值，引发路径错乱 - 绝对不要用
go env -w GOPATH=...，它写入$HOME/go/env是纯文本，无权限控制，多人共用 home 目录时极易被覆盖或误读
最常被忽略的点是：离线环境里 go.sum 文件不能少，也不能手动编辑。哪怕所有模块都已放好，只要某行 checksum 和本地文件实际哈希不匹配，Go 就会拒绝构建，且错误提示里不会告诉你哪一行错了——只能靠 go mod verify 逐个排查。
