离线搭建Go环境必须提前在联网机完成三件事：下载匹配版本的go二进制包、拉取全部依赖至$GOPATH/pkg/mod/cache/download/、关闭校验机制；否则go build会在module lookup或checksum验证阶段失败。
离线搭建 Go 环境不是“解压完就能用”，而是必须提前在联网机器上完成三件事：下载匹配版本的 go 二进制包、拉取全部依赖模块到 $GOPATH/pkg/mod/cache/download/、关闭校验机制；缺一环，go build 就会在 module lookup 或 checksum 验证阶段卡死。
如何验证 go 二进制包是否真正可用
解压 go1.22.3.linux-amd64.tar.gz 后，go version 报错或显示 unknown 是常见现象——这不是包损坏，而是 GOROOT 没被子进程继承。
- 必须将
export GOROOT=/usr/local/go和export PATH=$GOROOT/bin:$PATH写入/etc/profile.d/golang.sh（而非仅~/.bashrc），否则 CI 脚本、systemd 服务、VS Code 终端都读不到 - 执行
source /etc/profile.d/golang.sh后，新开终端运行go env GOROOT，输出应为完整路径；若为空，说明 shell 启动时未加载该文件 - ARM 环境下要特别确认 tar 包名是否含
arm64，go version成功但go list -m allpanic，大概率是架构错配
为什么 go mod download 在离线机上仍会报 “no such host”
因为默认启用 GO111MODULE=on 且未显式关闭代理和校验，Go 仍会尝试连接 proxy.golang.org 和 sum.golang.org。
- 必须在离线机上执行：
go env -w GOPROXY=direct（不是空值，也不是off） - 必须执行：
go env -w GOSUMDB=off；设为off才真正跳过校验，设为""仍可能 fallback 到默认值 - 若项目含
replace指向私有 Git 地址，go build会尝试解析域名，此时还需加-mod=readonly防止自动修正
go mod vendor 后仍编译失败的典型原因
vendor/ 目录看似完整，但 Go 构建时仍可能去 $GOPATH/pkg/mod 查间接依赖或校验和，导致离线失败。
立即学习“go语言免费学习笔记（深入）”；
- 执行顺序不能错：
go mod tidy→go mod vendor→git add vendor/；漏掉tidy，vendor/modules.txt会缺失// indirect条目 -
vendor/不包含replace的本地路径模块，这些必须手动拷贝进vendor/并同步更新go.mod - 含 cgo 的包（如
net、os/user）即使 vendor 了，离线机也需装gcc、libc6-dev，否则报cannot find -lc
Windows 下 file:// 代理路径容易出错的写法
Windows 路径转 file:// URL 时，盘符和反斜杠处理不对会导致 go mod download 完全静默失败——不报错，但依赖不生效。
- 正确写法：
go env -w GOPROXY=file:///C:/Go/pkg/mod/cache/download（三个斜杠，盘符大写，正斜杠分隔） - 错误写法：
file://C:\Go\...（少一个/）、file:///c:/...（盘符小写）、file://C:/Go\...（混用反斜杠） - 验证方式：在项目根目录运行
go mod download -x golang.org/x/net，输出中应出现cachedir对应本地路径，而非发起 HTTP 请求
真正离线的标志不是“能编译出二进制”，而是整个过程无任何 DNS 查询和 TCP 连接尝试；建议在离线机上用 tcpdump -i any port 53 or port 443 抓包确认——哪怕一次 53 端口查询，都说明某处配置没关干净。
