核心卡点是go mod download阶段依赖拉取失败，需禁用外网代理并配对设置goproxy=direct与gosumdb=off，或部署athens/goproxy.cn内网代理及对应校验服务。
内网环境搭建 Golang 开发环境，核心卡点不是 Go 二进制本身，而是 go mod download 阶段无法拉取依赖——proxy.golang.org 和 GitHub 等源直连失败，导致 go get、go build 卡住或报错。必须绕过外网代理依赖，用内网可控方式提供模块分发能力。
内网没服务器？先禁用代理并确认 vendor 是否可用
如果只是临时在单台离线机器上编译已有项目，且项目已执行过 go mod vendor，可跳过代理部署，直接让 Go 忽略网络：
- 执行
go env -w GOPROXY=direct，强制跳过所有模块代理 - 同步关闭校验：执行
go env -w GOSUMDB=off，否则go build仍会尝试连接sum.golang.org - 验证是否生效：运行
go env GOPROXY GOSUMDB，输出应为direct和off - 注意：
go mod vendor不包含replace指向的本地路径或内网 Git 地址，这类依赖需提前手动放好，否则go build会报cannot find module
有内网服务器？部署 athens 或 goproxy.cn 离线镜像
athens 是官方推荐的 Go 模块代理服务，goproxy.cn 提供开源离线版（基于 Go 实现），二者都支持私有模块缓存和 direct 回源兜底逻辑：
- 在能出网的机器上拉取镜像：例如
docker run -d -p 3000:3000 -v /data/athens:/var/athens/storage gomods/athens:latest - 内网机器设代理指向该地址：
go env -w GOPROXY=http://192.168.10.5:3000,direct（把 IP 换成你服务器真实地址） - 必须加
,direct后缀，否则遇到未缓存的私有模块（如git.corp.example.com/lib）会直接 404，而不是 fallback 到直连 - 若使用 goproxy.cn 离线版，其默认不校验私有模块，但需额外配置
GONOSUMDB：例如go env -w GONOSUMDB="git.corp.example.com"
GOPROXY 和 GOSUMDB 必须配对关闭或内网化
只改 GOPROXY 不动 GOSUMDB，go build 仍会失败——Go 1.13+ 默认启用模块校验，即使有 vendor 或内网代理，也会单独请求 sum.golang.org 验证哈希：
-
GOSUMDB=off是最简方案，适合完全可信内网；生产环境建议部署内网校验服务（如自建 sumdb 镜像或用 athens 内置校验） - 若公司已有 Nexus/Artifactory，可配置 Go 插件支持模块代理和校验，此时
GOPROXY设为 Nexus 地址，GOSUMDB设为对应校验端点 - 错误示范：
GOPROXY=https://goproxy.cn却没加,direct，又没设GONOSUMDB，结果是公共模块能下，私有模块 404，校验阶段再报checksum mismatch
离线安装 Go 二进制后，GOROOT 和 PATH 容易设错
官网下载的 go1.23.4.linux-amd64.tar.gz 本身不联网，但解压后路径和环境变量错一个，go install 就可能写进错误目录或找不到标准库：
- 解压必须到固定根路径，例如
sudo tar -C /usr/local -xzf go*.tar.gz→ 得到/usr/local/go -
GOROOT必须显式设为该路径：go env -w GOROOT=/usr/local/go；不设时 Go 会自动推导，但 CI 工具或 IDE 可能读不到 -
PATH要包含$GOROOT/bin，且放在最前，避免系统包管理器装的老版本go被优先调用 - 验证命令：
which go应输出/usr/local/go/bin/go，go env GOROOT输出必须与之完全一致（无软链接、无尾部斜杠）
最容易被忽略的是：GOSUMDB 的行为独立于 GOPROXY，哪怕代理返回了模块 zip，Go 仍会单独发起一次校验请求；内网环境下，这个请求比模块下载更容易静默失败，且错误信息不直观——看到 verifying github.com/xxx@v1.2.3: checksum mismatch 时，第一反应不该是删 go.sum，而应先检查 GOSUMDB 设置。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
