平时我们在终端执行 go get 下载第三方包,或者在 VSCode 中安装 gopls 等扩展工具时,国内网络环境下很容易卡住半天。等上一段时间后,终端经常会报出类似下面的连接超时错误:
(报错)dial tcp 142.251.42.241:443: connectex: A connection attempt failed...出现这个报错并不是我们的代码写错了,而是因为 Go 语言默认的模块代理服务器 proxy.golang.org 位于海外,在国内无法直接访问。想要解决这个问题非常简单,我们只需要把模块下载源 GOPROXY 切换为国内镜像站就可以了。
常用的国内镜像源
GOPROXY 是 Go 官方提供的模块代理配置项,其中 proxy 是英文 “代理、中转站” 的意思。国内镜像站会提前把常用的 Go 开源包缓存到国内节点。配置好之后,我们执行 go get 或 go mod tidy 时就会直接从国内服务器拉取,下载速度非常快。
目前国内稳定且免费开放的 Go 模块镜像源如下表所示。
| 提供方 | 镜像地址 | 说明 |
|---|---|---|
| 七牛云(推荐) | https://goproxy.cn | 国内公益镜像源,稳定高速 |
| 阿里云 | https://mirrors.aliyun.com/goproxy/ | 阿里云维护的公共镜像源 |
| Goproxy.io | https://goproxy.io | 开源社区维护的代理镜像源 |
大多数国内开发者平时优先使用的都是七牛云维护的 goproxy.cn,配好这一条地址就够用了。
配置与验证 GOPROXY
以前如果想修改这类代理参数,通常需要去操作系统的设置面板里手动添加系统环境变量,步骤比较繁琐。
而在现在的 Go 版本中,我们只需要打开命令提示符、PowerShell 或编辑器的内置终端,执行一次 go env -w 命令即可。修改后的全局配置会永久保存,以后创建的所有 Go 项目都会自动生效。
语法:
# 写入并永久保存配置
go env -w GOPROXY="镜像地址,direct"
# 查看当前生效的 GOPROXY 配置
go env GOPROXY说明:
go env -w 中的 -w 是英文 “write(写入)” 的缩写,表示把配置写入 Go 自身的配置文件中永久保存,关闭终端或重启电脑后依然有效。
这里建议小伙伴们给等号后面的地址加上英文双引号。因为在 Windows 的 PowerShell 终端里,不加引号的英文逗号(,)会被当成参数分隔符而报错,加上双引号就能在所有系统的终端下通用。
为什么镜像地址末尾还要跟一个 ,direct 呢?这里的 direct 是英文 “直接连接” 的意思。把它跟在镜像地址后面,表示如果遇到刚发布或极冷门的包在镜像站里暂时找不到时,允许 Go 绕过镜像站,直接回原始代码仓库(如 GitHub)去拉取。
示例 1:配置并验证国内镜像源
# 1. 确保开启 Go Modules 模块模式
go env -w GO111MODULE=on
# 2. 将 GOPROXY 设置为七牛云国内镜像源
go env -w GOPROXY="https://goproxy.cn,direct"
# 3. 查看配置是否生效
go env GOPROXY运行结果如下。
https://goproxy.cn,direct分析:
第 1 行 go env -w GO111MODULE=on 表示确保开启 Go Modules 模块管理模式。从 Go 1.16 版本开始,该项默认就是 on,这里一并执行一次是为了防止旧环境曾经被改动过。
第 2 行设置好 GOPROXY 后,我们用第 3 行命令检查是否生效。只要终端输出 https://goproxy.cn,direct,就说明国内镜像源配置成功了。此时再去下载第三方库或安装编辑器插件,速度都会快很多。
注意:
- Windows 系统冲突处理:如果以前在系统里手动加过
GOPROXY,执行go env -w时会报does not override conflicting OS environment variable警告,意思是无法覆盖冲突的系统变量。此时打开系统 “环境变量” 面板删掉旧的GOPROXY,再重启终端重新执行即可。 - macOS 与 Linux 系统冲突处理:如果同样遇到系统变量冲突警告,打开
~/.zshrc或~/.bash_profile文件,移除原有的GOPROXY配置后重新打开终端再执行。
如果担心单个镜像站偶尔维护,我们还可以同时配置两个镜像源互为备份。
示例 2:串联配置备用镜像源
# 1. 用英文逗号串联七牛云与阿里云镜像源
go env -w GOPROXY="https://goproxy.cn,https://mirrors.aliyun.com/goproxy/,direct"
# 2. 查看当前生效的配置
go env GOPROXY运行结果如下。
https://goproxy.cn,https://mirrors.aliyun.com/goproxy/,direct分析:
在上面的命令中,我们使用英文逗号(,)把七牛云和阿里云两个镜像地址串联了起来。下载依赖包时,Go 会优先从排在第 1 位的 goproxy.cn 拉取。只有当第 1 个地址请求失败时,才会自动切换到第 2 个阿里云地址。
此外,如果以后想要撤销通过 go env -w 写入的自定义设置,我们可以执行下面的命令:
go env -u GOPROXY其中 -u 是英文 “unset(取消设置)” 的缩写,执行后就会把 GOPROXY 恢复成 Go 出厂时的默认状态。平时正常开发时保留国内镜像源就可以了,不需要执行这条取消命令。
私有仓库配置 GOPRIVATE
在个人学习或使用公开的开源包时,只要配好上面的 GOPROXY 就够用了。不过进入公司参与团队开发后,公司内部一般会搭建自己的私有代码仓库,比如域名为 git.mycompany.com 的内网 GitLab。
公司内网的私有代码包不会出现在外部公共镜像站里,如果依然去公共镜像站查找就会报错。遇到这种情况,我们可以执行 go env -w GOPRIVATE="*.mycompany.com",让匹配该域名的私有包直接跳过公共代理,走公司内网拉取。
对于正在学习基础语法的小伙伴来说,本地没有公司内网私有仓库,暂时不需要配置 GOPRIVATE。
