Golang离线安装包下载与内网环境安装教程-Golang-PHP中文网

离线安装Go必须在联网机完成三件事：校验二进制包SHA256、预拉取全部依赖至$GOPATH/pkg/mod/cache/download/、固化GOPROXY=direct与GOSUMDB=off；否则离线机go build必卡在模块解析或校验阶段。

golang离线安装包下载与内网环境安装教程

离线安装 Go 不是“解压完就完事”，必须在联网机上提前完成二进制包校验、依赖预拉取、环境变量固化三件事；否则内网机器上 go build 会卡在模块解析或校验阶段，报 no such host 或 checksum mismatch。

怎么下载并验证 Go 离线安装包

不能直接 curl https://go.dev/dl/，必须人工下载 + 本地校验。官网下载页（https://go.dev/dl/）下方明确列出每个包的 SHA256 哈希值，这是唯一可信依据。

Linux x86_64：下载 go1.24.4.linux-amd64.tar.gz；ARM64 机器务必选 go1.24.4.linux-arm64.tar.gz，错配会导致 go list -m all panic
Windows：下载 go1.24.4.windows-amd64.zip（非 MSI），MSI 安装器会尝试联网激活或写注册表，不适用于离线分发
校验命令（Linux/macOS）：sha256sum go1.24.4.linux-amd64.tar.gz，输出必须与官网页面完全一致
解压路径要固定：Linux 推荐 /usr/local/go，Windows 推荐 C:\Go；避免解压到用户目录再软链，systemd、CI 脚本和 VS Code 终端都可能读不到

为什么 `go version` 成功但 `go mod download` 失败

因为默认 GO111MODULE=on，且未关闭代理和校验机制，Go 仍会硬连 proxy.golang.org 和 sum.golang.org —— 这两个域名在内网必然解析失败。

必须在离线机上执行：go env -w GOPROXY=direct（不是 off，off 会跳过缓存查找逻辑）
必须执行：go env -w GOSUMDB=off（设为空字符串 "" 仍会 fallback 到默认值）
如果项目含 replace 指向私有 Git 地址（如 replace example.com/foo => ./local/foo），还需加 -mod=readonly 防止构建时自动修正路径
验证是否生效：go env GOPROXY GOSUMDB 输出应为 direct 和 off，不是空或默认地址

如何让依赖在离线机上真正可用

只靠 go mod vendor 不够，vendor 目录不包含间接依赖的校验信息，也不处理 replace 的本地路径模块；Go 构建时仍会去 $GOPATH/pkg/mod 查找，导致失败。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

推荐方案：在外网机执行 go mod download，然后整份复制 $GOPATH/pkg/mod 目录到离线机同路径下（注意 GOPATH 必须一致）
若必须用 vendor：执行顺序必须是 go mod tidy → go mod vendor → git add vendor/；漏掉 tidy，vendor/modules.txt 会缺失 // indirect 条目
replace 指向本地路径的模块，必须手动拷贝进 vendor/ 对应位置，并同步更新 go.mod 中的 replace 行为指向 ./vendor/xxx
含 cgo 的包（如 net、os/user）即使 vendor 了，离线机也需预装 gcc 和 libc6-dev（Linux）或 MinGW（Windows），否则报 cannot find -lc

gopls 和 dlv 怎么离线部署

gopls 和 dlv 无法在内网用 go install，因为它们依赖大量第三方模块，执行时会卡在 Fetching … 或报 cannot find package。

在外网机执行：go install golang.org/x/tools/gopls@latest 和 go install github.com/go-delve/delve/cmd/dlv@latest
找到生成的可执行文件：$GOPATH/bin/gopls 和 $GOPATH/bin/dlv（Linux/macOS）或 %USERPROFILE%\go\bin\gopls.exe（Windows）
复制到内网机的 /usr/local/go/bin/（Linux）或 C:\Go\bin\（Windows），并确保执行权限（Linux 上用 chmod +x）
VS Code 中禁用自动安装，在设置里显式指定："go.goplsPath": "/usr/local/go/bin/gopls" 和 "go.dlvPath": "/usr/local/go/bin/dlv"

最易被忽略的是环境变量加载时机：写入 /etc/profile.d/golang.sh 后，必须新开终端或运行 source /etc/profile.d/golang.sh，否则 CI 脚本、systemd 服务、VS Code 内置终端都读不到 GOROOT；而 go version 成功但 go env GOROOT 为空，基本就是这个原因。