推荐设置 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,毫秒级响应即成功
跳过 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 分支。
95Shop可以免费下载使用,是一款仿醉品商城网店系统,内置SEO优化,具有模块丰富、管理简洁直观,操作易用等特点,系统功能完整,运行速度较快,采用ASP.NET(C#)技术开发,配合SQL Serve2000数据库存储数据,运行环境为微软ASP.NET 2.0。95Shop官方网站定期开发新功能和维护升级。可以放心使用! 安装运行方法 1、下载软件压缩包; 2、将下载的软件压缩包解压缩,得到we
- 查可用版本:
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 当成完全离线方案——这些地方一错,整个构建链就卡在某个不起眼的报错里,反复重试反而浪费时间。









