GoFrame安装慢需配置国内模块代理,推荐执行go env -w GOPROXY=https://goproxy.cn,direct并确保GO111MODULE=on,私有仓库通过GONOPROXY排除,验证时观察Fetching日志是否含goproxy.cn。

GoFrame框架安装慢是因为go install或go get默认直连境外模块服务器,国内网络环境下常出现超时、卡死或403错误,必须配置国内模块代理才能稳定下载。
确认当前Go模块代理状态
执行命令查看当前GOPROXY设置:go env GOPROXY。如果输出是https://proxy.golang.org,direct或空值,说明未启用国内镜像,安装必然缓慢甚至失败。
配置国内模块代理(永久生效)
方法一:使用七牛云goproxy.cn(推荐,稳定性最高)
在终端中运行:go env -w GOPROXY=https://goproxy.cn,direct
方法二:阿里云镜像(适合企业内网环境)
执行:go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct
【必须同时开启模块模式】:若尚未启用Go Modules,需补设go env -w GO111MODULE=on,否则代理不生效。
针对私有仓库跳过代理
如果你的项目依赖公司内部Git服务(如git.example.com),需排除代理避免认证失败:
执行go env -w GONOPROXY=git.example.com。多个域名用逗号分隔,例如git.example.com,mycorp.internal。
验证代理是否起效
第一步:清理本地缓存避免干扰go clean -modcache
第二步:拉取一个轻量公共模块测试速度go get github.com/gogf/gf/v2@v2.10.0
第三步:观察终端输出——若看到Fetching https://goproxy.cn/github.com/gogf/gf/v2/@v/v2.10.0.info类日志,且5秒内完成,说明代理已正常工作。











