Go Module 常见问题

bysir · · 2871 次点击 · · 开始浏览    
这是一个创建于 的文章,其中的信息可能已经有所发展或是发生改变。

为什么使用Go Module?

  • 不需要将项目放在GOPATH以及长长的路径下
  • 依赖库的版本控制
  • 有GOPROXY,拉取任何代码都十分方便

如何使用

在go module才诞生的前几个版本中使用它你会遇到诸多疑难杂症,但在1.13版本中go module已经足够完善,所以我推荐升级到1.13版本。这篇文章记录的也是在Go1.13环境下遇到的问题。

如何使用并不是此文重点,所以请读官方文章:

常见问题

Proxy

我们的项目总会依赖到墙外的包,如google.golang.org/grpc、golang.org/x/net,在没有go module的时候我们有很多复杂的办法来获取他们,但现在不需要再这么麻烦,只需要一行代码:

go env -w GOPROXY=https://goproxy.cn,direct

设置好GOPROXY之后,在go module环境下(运行过 go mod init的文件夹中)拉取墙外的包:go get golang.org/x/net就会飞快。

私有仓库

go module有在服务器端CheckSum的验证逻辑,但私有仓库无法被外部服务器访问,所以私有仓库无法像公共仓库一样正常被go module获取。

为了解决这个问题,Go1.13引入了新的环境变量:GOPRIVATE。

例如内部包路径是这样:go.bysir.top/xxx/xxx,那我们就可以如下设置

go env -w GOPRIVATE=go.bysir.top

它是前缀匹配的,设置为go.bysir.top则意味着所有以go.bysir.top开头的包都会被视为是私有的。

私有的包不会走代理,也不会有CheckSum逻辑。

好了,现在解决了go mod的问题,却还有一个更严峻的问题是如何让我们自己的服务器(或电脑)有权限获取这个仓库呢?

假设私有包名是go.bysir.top/go,那么我们要获取这个包则需要运行以下Shell:

go get go.bysir.top/go

如果你是在开发机器上获取这个私有包,可能会很顺利的获取到私有包,这是因为很可能在这个机器上已经记录了仓库的登陆账号密码,你可以查看这个git文档了解原理:Git-工具-凭证存储。否则的话,可能会遇到下面的错误

get "go.bysir.top/go": found meta tag get.metaImport{Prefix:"gitlab.com/xxx", VCS:"git", RepoRoot:"https://go.bysir.top/go.git"} at //go.bysir.top/go?go-get=1
go get go.bysir.top/go: git ls-remote -q https://go.bysir.top/go.git in /Users/bysir/go/pkg/mod/cache/vcs/91fae55e78195f3139c4f56af15f9b47ba7aa6ca0fa761efbd5b6e2b16d5159d: exit status 128:
    fatal: could not read Username for 'https://go.bysir.top': terminal prompts disabled
Confirm the import path was entered correctly.
If this is a private repository, see https://golang.org/doc/faq#git_https for additional information.

解决办法之一是先使用git clone一次仓库,git clone https://go.bysir.top/go.git,输入账号密码,目的是让git记录上账号密码。

如果你是在CI机器上获取这个私有包,那么更好的方式是刚刚的错误提示中提到的文章(https://golang.org/doc/faq#git_https)中的方法:

配置.netrc

echo "machine {Server} login {Repo UserName} password {Password}"> ~/.netrc

例如

machine go.bysir.top login bysir password mypwd

自定义包名

一般来说私有仓库的git地址并不美观,就拿coding来说,它的项目地址是这样的:https://e.coding.net/bysir/go.git,我们并不想拿它当做包名,那我们是否可以自定义导入包名呢?

github上有一个程序可以用来实现自定义导入包名:Go Vanity URLs

Go Vanity URLs is a simple App Engine Go app that allows you to set custom import paths for your Go packages.

原理很简单:go-import meta tag


有疑问加站长微信联系(非本文作者)

本文来自:简书

感谢作者:bysir

查看原文:Go Module 常见问题

入群交流(和以上内容无关):加入Go大咖交流群,或添加微信:liuxiaoyan-s 备注:入群;或加QQ群:692541889

2871 次点击  
加入收藏 微博
暂无回复
添加一条新回复 (您需要 登录 后才能回复 没有账号 ?)
  • 请尽量让自己的回复能够对别人有帮助
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
  • 支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet
  • 图片支持拖拽、截图粘贴等方式上传