失败主因是 go mod download 卡在代理不可达或校验失败，需显式配置多源 goproxy（如“https://goproxy.cn,direct”）、同步系统时间、临时禁用 gosumdb（调试时），并确认 go 命令可用而网络策略生效。
直接结论：失败主因不是“装不上 Go”，而是 go mod download 卡在代理不可达或校验失败——必须显式配置多源 GOPROXY 并同步修复系统时间、禁用 GOSUMDB（仅限调试）。
确认 go 命令能运行，但 go mod download 超时或 403
这是最典型的“网络限制”现象：go version 正常，但一执行依赖拉取就卡住或报错 Get "https://proxy.golang.org/...": dial tcp 216.239.37.1:443: i/o timeout 或 403 Forbidden。本质是模块代理未生效，Go 默认仍尝试直连境外地址。
- 立刻执行：
go env -w GOPROXY="https://goproxy.cn,direct"（国内首选）或go env -w GOPROXY="https://mirrors.tuna.tsinghua.edu.cn/goproxy/,direct"（清华源） - 不要只写一个地址——
direct必须保留，否则私有模块或本地 replace 会彻底失败 - 验证是否生效：
go env GOPROXY输出应为设置的字符串，不是空或https://proxy.golang.org - 若虚拟机/云服务器在内网，且公司有 HTTP 代理（注意不是 HTTPS），可设为：
go env -w GOPROXY="http://your-proxy:8080"
go mod download 卡在 checksum 验证或报 checksum mismatch
这不是依赖包被篡改，而是 GOSUMDB 尝试连接 sum.golang.org 失败导致校验流程中断。该服务在国内同样受限，且 TLS 时间戳校验对系统时间极其敏感。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 临时调试用（开发机/测试环境）：
go env -w GOSUMDB=off - 生产环境不能关，应搭配可信代理：
go env -w GOSUMDB=sum.golang.org+GOPROXY同时指向支持校验转发的镜像（如 goproxy.cn 支持） - 强制同步系统时间（极易被忽略）：
sudo timedatectl set-ntp true或sudo ntpdate -s time.windows.com；时间误差超 3 分钟就会触发 TLS 证书过期误判，表现为x509: certificate has expired or is not yet valid
用包管理器安装后 go 命令仍找不到
Ubuntu 的 apt install golang 或 CentOS 的 yum install golang 安装的是旧版（如 Ubuntu 22.04 默认是 go1.18），且二进制路径不统一：/usr/bin/go 或 /usr/lib/golang/bin/go，PATH 可能未自动包含。
- 先查真实路径：
find /usr -name go 2>/dev/null或dpkg -L golang | grep bin/go（Debian/Ubuntu） - 手动加到 PATH：
echo 'export PATH=$PATH:/usr/lib/golang/bin' >> ~/.bashrc && source ~/.bashrc - 更稳妥的做法是跳过包管理器，直接下载官方
go1.23.4.linux-amd64.tar.gz解压到/usr/local/go，再设GOROOT—— 版本可控、路径标准、无兼容风险
离线环境或内网机器无法拉取任何模块
没有网络时，go mod download 必然失败。此时不能靠“配代理”解决，必须提前在有网机器上完成依赖固化。
- 在与目标环境**完全一致的 Go 版本**下执行：
go mod tidy && go mod download -x，确认所有模块落盘到$GOPATH/pkg/mod/cache/download/ - 将整个
$GOPATH/pkg/mod/cache目录打包，拷贝到离线机，然后起本地代理：goproxy -proxy=file:///path/to/cache（需提前go install github.com/goproxy/goproxy@latest） - 离线机设：
go env -w GOPROXY=http://localhost:8080 - 或者更简单粗暴：
go mod vendor后，所有构建命令加-mod=vendor参数，全程不碰网络
真正卡住人的从来不是“怎么装 Go”，而是 GOPROXY 配单源、GOSUMDB 没关、系统时间不同步这三件事同时发生——它们叠加起来会让错误信息变得毫无指向性。动手前先敲 go env | grep -E "(GOPROXY|GOSUMDB|GOROOT)" 和 timedatectl status，比反复重装快得多。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
