從gopath到go mod的一次嘗試


windows下的嘗試:

gomod初嘗試
下載官方包1.11(及其以上版本將會自動支持gomod) 默認GO111MODULE=auto(auto是指如果在gopath下不啟用mod)
go mod help查看幫助
go mod init<項目模塊名稱>初始化模塊,會在項目根目錄下生成 go.mod文件。

go mod tidy根據go.mod文件來處理依賴關系。

go mod vendor將依賴包復制到項目下的 vendor目錄。建議一些使用了被牆包的話可以這么處理,方便用戶快速使用命令go build -mod=vendor編譯

go list -m all顯示依賴關系。go list -m -json all顯示詳細依賴關系。

go mod download <path@version>下載依賴。參數<path@version>是非必寫的,path是包的路徑,version是包的版本。

在gopath外新建一個項目,單獨開一個cmd設置set GO111MODULE=on(習慣性的和git初始化一樣)go mod init然后報錯了。 正解如下:go mod init xxx(module名稱可與文件名不同)

在項目目錄下執行go mod tidy下載完成后項目路徑下會生成go.mod和go.sum

go.mod文件必須要提交到git倉庫,但go.sum文件可以不用提交到git倉庫(git忽略文件.gitignore中設置一下)。

go模塊版本控制的下載文件及信息會存儲到GOPATH的pkg/mod文件夾里。

在國內訪問golang.org/x的各個包都需要翻牆,我們可以在go.mod中使用replace替換成github上對應的庫。(強烈建議翻牆,我使用的lantern專業版+proxifier)非常穩定

replace (
golang.org/x/crypto v0.0.0-20180820150726-614d502a4dac => github.com/golang/crypto v0.0.0-20180820150726-614d502a4dac
golang.org/x/net v0.0.0-20180821023952-922f4815f713 => github.com/golang/net v0.0.0-20180826012351-8a410e7b638d
golang.org/x/text v0.3.0 => github.com/golang/text v0.3.0
)
1
2
3
4
5
以下是在公司項目中碰到的幾點坑

在引用mongodb的包時候報錯
go mod labix.org/v2/mgo@v0.0.0-20140701140051-000000000287: bzr branch --use-existing-dir
解決辦法 谷歌論壇
在go.mod中

replace (
labix.org/v2/mgo => github.com/go-mgo/mgo v0.0.0-20160801194620-b6121c6199b7
launchpad.net/gocheck => github.com/go-check/check v0.0.0-20180628173108-788fd7840127
)
1
2
3
4
引入本地包的方法(在go.mod中)
require (
test v0.0.0
)

replace (
test => ../test
)

注意:1.引入的包必須也是gomod的(有.mod文件)
2.replace時必須使用相對路徑比如../ ./
3.require 的包后必須帶版本號,replace中可帶可不帶
1
2
3
4
5
6
7
8
9
10
11
go.mod文件必須傳入git服務器上
linux下的嘗試
幾乎都是翻牆的問題

replace (
cloud.google.com/go => github.com/googleapis/google-cloud-go v0.34.0
github.com/go-tomb/tomb => gopkg.in/tomb.v1 v1.0.0-20141024135613-dd632973f1e7
go.opencensus.io => github.com/census-instrumentation/opencensus-go v0.19.0
go.uber.org/atomic => github.com/uber-go/atomic v1.3.2
go.uber.org/multierr => github.com/uber-go/multierr v1.1.0
go.uber.org/zap => github.com/uber-go/zap v1.9.1

golang.org/x/crypto => github.com/golang/crypto v0.0.0-20181001203147-e3636079e1a4
golang.org/x/lint => github.com/golang/lint v0.0.0-20181026193005-c67002cb31c3
golang.org/x/net => github.com/golang/net v0.0.0-20180826012351-8a410e7b638d
golang.org/x/oauth2 => github.com/golang/oauth2 v0.0.0-20180821212333-d2e6202438be
golang.org/x/sync => github.com/golang/sync v0.0.0-20181108010431-42b317875d0f
golang.org/x/sys => github.com/golang/sys v0.0.0-20181116152217-5ac8a444bdc5
golang.org/x/text => github.com/golang/text v0.3.0
golang.org/x/time => github.com/golang/time v0.0.0-20180412165947-fbb02b2291d2
golang.org/x/tools => github.com/golang/tools v0.0.0-20181219222714-6e267b5cc78e
google.golang.org/api => github.com/googleapis/google-api-go-client v0.0.0-20181220000619-583d854617af
google.golang.org/appengine => github.com/golang/appengine v1.3.0
google.golang.org/genproto => github.com/google/go-genproto v0.0.0-20181219182458-5a97ab628bfb
google.golang.org/grpc => github.com/grpc/grpc-go v1.17.0
gopkg.in/alecthomas/kingpin.v2 => github.com/alecthomas/kingpin v2.2.6+incompatible
gopkg.in/mgo.v2 => github.com/go-mgo/mgo v0.0.0-20180705113604-9856a29383ce
gopkg.in/vmihailenco/msgpack.v2 => github.com/vmihailenco/msgpack v2.9.1+incompatible
gopkg.in/yaml.v2 => github.com/go-yaml/yaml v0.0.0-20181115110504-51d6538a90f8
labix.org/v2/mgo => github.com/go-mgo/mgo v0.0.0-20160801194620-b6121c6199b7
launchpad.net/gocheck => github.com/go-check/check v0.0.0-20180628173108-788fd7840127
)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
主要包括:
golang.org
google.golang.org
gopkg.in
go.uber.org
cloud.google.com在下載包時會有timeout 導致編譯失敗,以上是對應的github的庫

參考資料

ieevee.com
鳥窩
segmentfault

--------------------分割線---------------------------------------------------------

Go Module 工程化實踐(一):基礎概念篇
Go Module 工程化實踐(二):go get 取包原理篇
根據以上資料總結

gopath 與go mod的區別
環境變量GOPATH不再用於解析imports包路徑,即原有的GOPATH/src/下的包,通過import是找不到了。
Go Module功能開啟后,下載的包將存放與$GOPATH/pkg/mod路徑
$GOPATH/bin路徑的功能依舊保持

1
2
3
4
go get 流程的變化
老的go get取包過程類似:git clone + go install , 開啟Go Module功能后go get就只有 git clone 或者 download過程了。
新老實現還有一個不同是,兩者存包的位置不同。前者,存放在$GOPATH/src目錄下;后者,存放在$GOPATH/pkg/mod目錄下。
老的go get取完主包后,會對其repo下的submodule進行循環拉取。新的go get不再支持submodule子模塊拉取。
1
2
3
依賴包的變化
三方遠程包:
檢查遠程倉庫最新的tag版本,有就取得該版本
遠程倉庫沒有tag版本時,直接獲取master分支的HEAD版本
如果在go.mod文件中指定了具體版本,go get直接獲取該指定版本
go.mod中除了可以指定具體版本號以外,還支持分支名

本地包:
通過replace()進行替換

1
2
3
4
5
6
7
8
9
私有倉庫權限和私有vcs非標准路徑取包問題
權限問題
windows10下:
控制面板>用戶賬戶>憑據管理手動添加普通憑據即可
linux下:
增加 $HOME/.gitconfig 配置:
[url "ssh://git@github.com/MYORGANIZATION/"]
insteadOf = https://github.com/MYORGANIZA...

增加 $HOME/.netrc:
machine github.com login YOU password APIKEY
將其中的 APIKEY 換成自己的登錄KEY。

非標准路徑問題(https://private.vcs.com:20000)
搭建一個中間服務:https://private.vcs.com 能夠通過go get的包路徑匹配查詢正確的倉庫地址。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM