推荐设置 GOPROXY=https://goproxy.cn,direct 实现国内加速与私有模块直连，支持多镜像 fallback；遇 checksum mismatch 可临时 -insecure 或 clean -modcache；go install 需指定精确版本；离线场景用 go mod download 预缓存或搭私有代理。
用 GOPROXY 快速切换国内镜像源
默认的 https://proxy.golang.org 在国内经常超时或返回 403，直接导致 go get 失败。必须显式设置代理，且优先使用支持 Go Module 的稳定镜像。
- 推荐设置：
export GOPROXY=https://goproxy.cn,direct（Linux/macOS）或set GOPROXY=https://goproxy.cn,direct（
Windows CMD） -
direct是关键：它表示对私有模块（如公司内网 Git 地址、gitlab.example.com）跳过代理，避免认证失败 - 不要只设一个地址，多个镜像用英文逗号分隔可实现自动 fallback，例如：
https://goproxy.cn,https://goproxy.io,direct - 验证是否生效：运行
go env GOPROXY，输出应含goproxy.cn；再试go list -m github.com/go-sql-driver/mysql，毫秒级响应即成功
Windows CMD）跳过 checksum 验证（仅限临时调试）
当 GOPROXY 正常但仍有 verifying github.com/xxx@vX.Y.Z: checksum mismatch 报错，大概率是模块索引缓存污染或镜像同步延迟。不建议全局关 checksum，但可精准绕过：
- 临时禁用校验（仅当前命令）：
go get -insecure github.com/xxx/yyy - 或清除本地校验缓存：
go clean -modcache，再重试go get - 注意：
GOINSECURE环境变量会影响所有私有域名，慎用；若必须设，限定范围如export GOINSECURE="git.internal.company" - 常见误操作：在
go.mod里手动改replace指向本地路径却忘了删// indirect标记，会导致 checksum 计算逻辑异常
用 go install 安装 CLI 工具时指定版本
很多 Golang 工具（如 gofmt、swag、mockgen）依赖特定版本，直接 go install xxx@latest 可能拉到不兼容的 master 分支。
- 查可用版本：
go list -m -versions github.com/swaggo/swag - 安装指定版本：
go install github.com/swaggo/swag/cmd/swag@v1.8.10 - Go 1.21+ 默认启用
GOPATH模式外的模块感知安装，确保GOBIN已加入$PATH，否则执行时提示command not found - 国内镜像对
@version查询支持良好，但部分小众工具 tag 名含破折号（如v2.0.0-alpha），需用双引号包裹：go install "github.com/xxx/yyy@v2.0.0-alpha"
离线预下载依赖到私有模块代理
在 CI/CD 或无外网权限的生产环境，不能依赖实时拉取。需提前构建可离线使用的模块缓存。
立即学习“go语言免费学习笔记（深入）”；
- 用
go mod download预热：go mod download && tar -czf gomod-cache.tgz $(go env GOMODCACHE) - 解压到目标机器的
$HOME/go/pkg/mod下，再设export GOMODCACHE=$HOME/go/pkg/mod - 更可靠的方式是搭轻量私有代理（如
athens），配置GO_PROXY=http://your-athens:3000，首次请求会自动缓存并 serve 后续请求 - 注意：
go mod vendor不解决构建时的 proxy 依赖，它只复制源码；vendor 目录仍需GOPROXY=off才能跳过网络校验
GOPROXY 里漏掉 ,direct、go install 时没写清楚版本号、或者把 vendor 当成完全离线方案——这些地方一错，整个构建链就卡在某个不起眼的报错里，反复重试反而浪费时间。
