离线内网环境下go build卡住或报checksum mismatch，根本原因是模块系统默认依赖proxy.golang.org和sum.golang.org；必须配对设置goproxy=direct与gosumdb=off，并检查go.sum换行符或空格，禁用cgo以生成静态二进制。
离线内网环境下 go build 卡住、报 connection refused 或 checksum mismatch，不是 Go 安装失败，而是模块系统默认依赖公网服务——只要没切断对 proxy.golang.org 和 sum.golang.org 的隐式调用，就一定会失败。
go mod download 卡在 “Fetching…” 怎么办
这是最常见现象，本质是 Go 1.13+ 默认启用 GOPROXY=https://proxy.golang.org，而内网无法解析或连接该地址，进程挂起但不报错。
- 临时验证：运行
go env -w GOPROXY=direct，再试go mod download—— 若成功，说明确实是代理问题；若仍失败，说明缓存缺失或go.sum不匹配 - 长期方案必须配对设置：
GOPROXY=direct+GOSUMDB=off，否则即使跳过代理，校验阶段仍会尝试访问sum.golang.org - 不要只改当前 shell：写入
/etc/profile.d/golang.sh（Linux）或系统级环境变量（Windows），确保 CI、systemd、IDE 都能继承 - 验证是否生效：
go env GOPROXY GOSUMDB输出应为direct和off，不是空值或默认地址
离线机器执行 go build 报 checksum mismatch
这不是网络问题，而是本地缓存内容与 go.sum 记录的哈希不一致。常见于跨平台拷贝缓存、手动编辑 go.sum 或换行符污染。
- 优先检查
go.sum文件末尾是否有空格、\r\n（Windows 换行），可用file go.sum或hexdump -C go.sum | tail确认 - 不要运行
go clean -modcache—— 这会清掉你辛苦带进来的全部依赖缓存 - 若用
go mod vendor，注意它不处理replace到本地路径的模块，这些必须手动git clone并保持目录结构一致 - 调试时可临时加参数绕过：
go build -mod=readonly -modcacherw，但仅限验证，上线必须修复go.sum或重拉缓存
交叉编译产物在目标机器报 not a valid ELF executable
典型症状是本地 file myapp 显示 ELF 64-bit LSB executable, x86-64，但目标机执行时报错。根源是 CGO 启用后混入了宿主机 libc 动态链接。
- 强制禁用 CGO：
CGO_ENABLED=0 go build -o myapp-linux-amd64—— 这是离线部署最安全的底线，生成纯静态二进制 - 确认目标架构真实值：在目标机运行
uname -m，别凭经验猜amd64；ARM 服务器可能是aarch64而非arm64 - 构建前清缓存：
go clean -cache -modcache，尤其从 macOS 编译 Linux 时，$HOME/Library/Caches/go-build可能残留 darwin 构建物，污染结果 - 若项目必须用 cgo（如调用 C 库），则目标机需预装对应
gcc、libc6-dev或devtoolset，且版本要匹配——离线环境里这比 Go 本身更难搞定
go install 写到奇怪路径或 command not found
根本原因是 GOROOT 和 PATH 不匹配，尤其解压后没显式设 GOROOT，Go 会自动推导，但 go install 可能写进 /root/go/bin 而不是你预期的 /usr/local/go/bin。
- 解压后必须显式设置：
go env -w GOROOT=/usr/local/go（路径以你实际解压位置为准） -
PATH必须包含$GOROOT/bin，建议写入/etc/profile.d/golang.sh，内容为：export GOROOT=/usr/local/goexport PATH=$GOROOT/bin:$PATH - 验证两件事：
go version能执行，且go env GOROOT输出与解压路径完全一致 - 不要解压到家目录再软链——权限、路径继承、Ansible 推送都会出问题；统一用
/usr/local/go或/opt/go
真正麻烦的从来不是“能不能连网”，而是模块系统里那些默认开启、静默调用、不报错只卡住的依赖项。每一条 GOPROXY、GOSUMDB、CGO_ENABLED 的设置，都得和 go.mod 结构、缓存目录状态、目标机架构一一咬合，漏一个，构建就停在看不见的地方。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
