一键解决 go get golang.org/x 包失败

野性酷女 2023-05-30 08:47 31阅读 0赞

From：[https://segmentfault.com/a/1190000018264719][https_segmentfault.com_a_1190000018264719]

# 问题描述 #

在 ubuntu 上用 **sudo apt install golang-go** 安装 go 的 sdk，之后使用 `go get`、`go install`、`go mod` 等命令时 (会自动下载相应的包或依赖包) 时，但由于众所周知的原因(**墙**)，类似于 `golang.org/x/...` 的包会出现下载失败的情况。如下所示：

$ go get -u golang.org/x/sys
    
    go get golang.org/x/sys: unrecognized import path "golang.org/x/sys" 
    (https fetch: Get https://golang.org/x/sys?go-get=1: dial tcp 216.239.37.1:443: i/o timeout)

# 解决方式 #

那我们该如何解决问题呢？下面列出几种方法。

### 1. 手动下载 ###

golang 在 github 上建立了一个镜像库，下载 github 上的镜像库放入 GOPATH 下即可。比如 golang.org/x/net 对应 [https://github.com/golang/net.git][https_github.com_golang_net.git] 。所以，我们可以手动下载 或 clone 对应的 GitHub 仓库到指定的目录下。

go 环境变量

export GOROOT=/usr/local/go
    export GOPATH=/home/king/go      # root用户可以设置为 export GOPATH=/root/go
    export PATH=$PATH:$GOROOT/bin

**GOROOT** 为安装目录   **GOPATH** 是 go 的工作区，代码和工程都可以添加到这里。

解决方法如下:

vim ~/.bashrc 
    
    或者
    
    vim /etc/profile

GG 到最后一行，添加:

export GOPATH=/root/go/

使配置生效

source .bashrc

安装 go 的 net 包。

mkdir -p $GOPATH/src/golang.org/x/
    
    cd $GOPATH/src/golang.org/x/
    
    git clone https://github.com/golang/net.git net 
    
    go install net

再之后，就可以愉快的 get了，比如如下:

go get github.com/lucas-clemente/quic-go

如果用源码安装 go，那么 install 会设置 GOPATH 和 net 的，看来 apt-get 就是一时爽，补丁还得自己打。

如果报 “ golang 程序编译时提示“package runtime: unrecognized import path "runtime" (import path does not begin with hostname)” ，可以执行：unset GOROOT  解决问题；

mkdir -p $GOPATH/src/golang.org/x/
    
    cd $GOPATH/src/golang.org/x/
    
    git clone https://github.com/golang/net.git
    git clone https://github.com/golang/sync.git
    
    go install net
    go install sync

项目放在 $GOPATH/src，执行 go get 即可成功。其它 golang.org/x 下的包获取皆可使用该方法。

**例如，很多go的软件在编译时都要使用tools里面的内容，使用下面方法获取：**

进入上面的 x 目录下，输入：

git clone https://github.com/golang/tools.git

***注意******：一定要保持与 go get 获取的目录结构是一致的，否则库就找不到了。***

get grpc 包的时候

$ go get google.golang.org/grpc

发现拉不下来被墙了，在 github.com上搜索 grpc，clone 到工程目录中，运行命令

go install google.golang.org/grpc

拿到了一些丢失的依赖包，比如：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ZyZWVraW5nMTAx_size_16_color_FFFFFF_t_70][]

进入 [https://github.com/golang][https_github.com_golang] 仓库找到对应的包，git clone下来，放到指定的目录中，比如上图缺少的 golang.org/x/net/http2包，在 github 上把 net 包 clone 下来，如下：

git clone https://github.com/golang/net.git $GOPATH/src/golang.org/x/net

其他包也如此操作，全部完成后，再运行

go install google.golang.org/grpc

成功，问题解决。

当如果需要指定版本的时候，该方法就无解了，因为 GitHub 上的镜像仓库多数都没有 tag。并且，手动嘛，程序员怎么能干呢，尤其是依赖的依赖，太多了。

go build -a    -x -v  
加上 -a 强制 go 重新编译。

### 2. 设置代理 ###

如果你 **有代理**，那么可以设置对应的环境变量：

export http_proxy=http://proxyAddress:port
    
    export https_proxy=http://proxyAddress:port

或者，直接用 `all_proxy`：

export all_proxy=http://proxyAddress:port

### 3. go mod replace ###

从 Go 1.11 版本开始，新增支持了 `go modules` 用于解决包依赖管理问题。该工具提供了 `replace`，就是为了解决包的别名问题，也能替我们解决 `golang.org/x` 无法下载的的问题。

`go module` 被集成到原生的 `go mod` 命令中，但是如果你的代码库在 `$GOPATH` 中，`module` 功能是默认不会开启的，想要开启也非常简单，通过一个环境变量即可开启 `export GO111MODULE=on`。

以下为参考示例：

module example.com/hello
    
    require (
    golang.org/x/text v0.3.0
    
    )
    
    replace (
    golang.org/x/text => github.com/golang/text v0.3.0
    )

类似的还有 [glide][]、[gopm][] 等这类第三方包管理工具，都不同方式的解决方案提供给我们。

### 4. GOPROXY 环境变量 ###

终于到了本文的终极大杀器 —— **GOPROXY**。

我们知道从 `Go 1.11` 版本开始，官方支持了 `go module` 包依赖管理工具。

其实还新增了 `GOPROXY` 环境变量。如果设置了该变量，下载源代码时将会通过这个环境变量设置的代理地址，而不再是以前的直接从代码库下载。这无疑对我等无法科学上网的开发良民来说是最大的福音。

更可喜的是，[goproxy.io][] 这个开源项目帮我们实现好了我们想要的。该项目允许开发者一键构建自己的 `GOPROXY` 代理服务。同时，也提供了公用的代理服务：[https://goproxy.io][https_goproxy.io]，我们只需设置该环境变量即可正常下载被墙的源码包了：

# Enable the go modules feature
    export GO111MODULE=on
    # Set the GOPROXY environment variable
    export GOPROXY=https://goproxy.io

把上面配置写入到 `.bashrc` 或者 `.bash_profile` 文件。重启系统使配置生效。

如果项目不在 `GOPATH` 中，则无法使用 `go get ...`，但可以使用 `go mod ...` 相关命令。也可以通过置空这个环境变量来关闭，`export GOPROXY=`。

对于 Windows 用户，可以在 `PowerShell` 中设置：

# Enable the go modules feature
    $env:GO111MODULE="on"
    # Set the GOPROXY environment variable
    $env:GOPROXY="https://goproxy.io"

最后，我们当然推荐使用 `GOPROXY` 这个环境变量的解决方式，前提是 **Go version >= 1.11**。

## 参考资料 ##

*  [goproxy.io for Go modules][]
 *  [goproxy.io][goproxy.io 1]

[https_segmentfault.com_a_1190000018264719]: https://segmentfault.com/a/1190000018264719
[https_github.com_golang_net.git]: https://github.com/golang/net.git
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ZyZWVraW5nMTAx_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20191108143542201.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ZyZWVraW5nMTAx,size_16,color_FFFFFF,t_70
[https_github.com_golang]: https://github.com/golang
[glide]: https://github.com/Masterminds/glide
[gopm]: https://github.com/gpmgo/gopm
[goproxy.io]: https://github.com/goproxyio/goproxy
[https_goproxy.io]: https://goproxy.io
[goproxy.io for Go modules]: https://mp.weixin.qq.com/s/COethtOaiygsYev-kkCc4A
[goproxy.io 1]: https://goproxy.io/