Go Modules與GOPROXY 配置

golangd 配置go mod 在博文底部

摘抄自https://studygolang.com/articles/24544 go語言中文網 在原基礎博客整理增長知識點 讓你完全名錶go mod
隨着Go 1.13發佈，GOPROXY默認值proxy.golang.org在中國大陸不能被訪問。

七牛雲順勢推出goproxy.cn，以利於中國開發者更好使用Go Modules，它是非盈利性的項目，首先感謝七牛雲。

Windows下使用教程:

（1）升級到Go1.13

（2）運行<go env -w GO111MODULE=on> //開啓mod

（3）運行<go env -w GOPROXY=https://goproxy.cn,direct> //設置七牛雲goproxy代理

能夠經過運行go env查看（2）、（3）步驟是否設置成功

（4）在項目跟目錄下執行go mod init <OPTIONAL_MODULE_PATH>

執行成功後生成go.mod文件

其餘指令

go get -u //更新現有的依賴
go mod tidy //整理模塊（拉取缺乏的模塊，移除不用的模塊）
go mod download//下載依賴包
go mod graph //打印現有依賴結構
go mod vendor //將依賴複製到vendor下
go mod verify //校驗依賴
go.mod文件解析
module：模塊名稱，使用指令go mod init <OPTIONAL_MODULE_PATH>可設置
require：依賴包列表以及版本
exclude：禁用依賴包列表
replace：替換依賴包列表
go：go版本號

goland編輯器中配置go mod

在goland的setting裏設置啓用Go Modules
goland Preference->Go->Go Modules(vgo) -> Enable Go Modules(vgo)intergration

勾選 Enable Go Modules(vgo)intergration 以後 ，

proxy配置(參考上圖)
https://goproxy.cn
點擊apply （應用）ok 便可。

______________________________________________________________
______________________________________________________________

---

gomod 的相關知識 摘抄自go 夜讀 （author：盛傲飛）

go.mod

module sss

go 1.13

require (
	github.com/astaxie/beego v1.12.0
	github.com/go-sql-driver/mysql v1.4.1
	github.com/julienschmidt/httprouter v1.3.0
	github.com/micro/examples v0.2.0
	github.com/micro/go-micro v1.18.0
)

go.mod 是啓用了 Go moduels 的項目所必須的最重要的文件，它描述了當前項目（也就是當前模塊）的元信息，每一行都以一個動詞開頭，目前有如下 5 個動詞:

• module：用於定義當前項目的模塊路徑。
• go：用於設置預期的 Go 版本。
• require：用於設置一個特定的模塊版本。
• exclude：用於從使用中排除一個特定的模塊版本。
• replace：用於將一個模塊版本替換爲另一個模塊版本。

這裏的填寫格式基本爲包引用路徑+版本號，另外比較特殊的是 go $version，目前從 Go1.13 的代碼裏來看，還只是個標識做用，暫時未知將來是否有更大的做用。
go.sum
go.sum 是相似於好比 dep 的 Gopkg.lock 的一類文件，它詳細羅列了當前項目直接或間接依賴的全部模塊版本，並寫明瞭那些模塊版本的 SHA-256 哈希值以備 Go 在從此的操做中保證項目所依賴的那些模塊版本不會被篡改。

example.com/apple v0.1.2 h1:WX...
example.com/apple v0.1.2/go.mod h1:xHW...
example.com/banana v1.2.3/go.mod h1:HS... 
...

example.com/apple v0.1.2 h1:WXk...
example.com/apple v0.1.2/go.mod h1:xH...

前者爲 Go modules 打包整個模塊包文件 zip 後再進行 hash 值，然後者爲針對 go.mod 的 hash 值。他們二者，要不就是同時存在，要不就是隻存在 go.mod hash。

那什麼狀況下會不存在 zip hash 呢，就是當 Go 認爲確定用不到某個模塊版本的時候就會省略它的 zip hash，就會出現不存在 zip hash，只存在 go.mod hash 的狀況。

GO111MODULE
這個環境變量主要是 Go modules 的開關，主要有如下參數：

• auto：只在項目包含了 go.mod 文件時啓用 Go modules，在 Go 1.13 中仍然是默認值，詳見 ：golang.org/issue/31857。
• on：無腦啓用 Go modules，推薦設置，將來版本中的默認值，讓 GOPATH 今後成爲歷史。
• off：禁用 Go modules。

GOPROXY
這個環境變量主要是用於設置 Go 模塊代理，主要以下：

• 它的值是一個以英文逗號 「,」 分割的 Go module proxy 列表（稍後講解）
• 做用：用於使 Go 在後續拉取模塊版本時可以脫離傳統的 VCS 方式從鏡像站點快速拉取。它擁有一個默認值，但很惋惜 proxy.golang.org 在中國沒法訪問，故而建議使用 goproxy.cn 做爲替代。
• 設置爲 「off」 ：禁止 Go 在後續操做中使用任 何 Go module proxy。

剛剛在上面，咱們能夠發現值列表中有 「direct」 ，它又有什麼做用呢？
其實值列表中的 「direct」 爲特殊指示符，用於指示 Go 回源到模塊版本的源地址去抓取 (好比 GitHub 等)，當值列表中上一個 Go module proxy 返回 404 或 410 錯誤時，Go 自動嘗試列表中的下一個，碰見 「direct」 時回源，碰見 EOF 時終止並拋出相似 「invalid version: unknown revision…」 的錯誤。

GOSUMDB
它的值是一個 Go checksum database，用於使 Go 在拉取模塊版本時(不管是從源站拉取仍是經過 Go module proxy 拉取)保證拉取到的模塊版本數據未經篡改，也能夠是「off」即禁止 Go 在後續操做中校驗模塊版本

• 格式: SUMDB_NAME+PUBLIC_KEY或SUMDB_NAME+PUBLIC_KEY SUMDB_URL。
• 擁有默認值： sum.golang.org (之因此沒有按照上面的格式是由於 Go 對默認值作了特殊處理)。
• 可被 Go module proxy 代理 (詳見：Proxying a Checksum Database)。
• GOSUMDB 的默認值在中國沒法訪問，故而更加建議將 GOPROXY 設置爲 goproxy.cn，由於 goproxy.cn 支持代理 sum.golang.org。

Go Checksum Database
Go checksum database 主要用於保護 Go 不會從任何源頭拉到被篡改過的非法 Go 模塊版本，其做用（左）和工做機制（右）以下圖：

若是有興趣的小夥伴能夠看看 Proposal: Secure the Public Go Module Ecosystem，有詳細介紹其算法機制，若是想簡單一點，查看 go helpmodule-auth 也是一個不錯的選擇。

GONOPROXY/GONOSUMDB/GOPRIVATE
這三個環境變量都是用在當前項目依賴了私有模塊，也就是依賴了由 GOPROXY 指定的 Go module proxy 或由 GOSUMDB 指定 Go checksum database 沒法訪問到的模塊時的場景，他們具備以下特性：

• 它們三個的值都是一個以英文逗號 「,」 分割的模塊路徑前綴，匹配規則同 path.Match。

• 其中 GOPRIVATE 較爲特殊，它的值將做爲 GONOPROXY 和 GONOSUMDB 的默認值，因此建議的最佳姿式是隻是用 GOPRIVATE。

在使用上來說，好比 GOPRIVATE=*.corp.example.com 表示全部模塊路徑以 corp.example.com 的下一級域名 (如 team1.corp.example.com) 爲前綴的模塊版本都將不通過 Go module proxy 和 Go checksum database，須要注意的是不包括 corp.example.com 自己。
Global Caching
這個主要是針對 Go modules 的全局緩存數聽說明，以下：

• 同一個模塊版本的數據只緩存一份，全部其餘模塊共享使用。
• 目前全部模塊版本數據均緩存在 $GOPATH/pkg/mod和 $GOPATH/pkg/sum 下，將來或將移至 $GOCACHE/mod和 $GOCACHE/sum 下( 可能會在當 $GOPATH 被淘汰後)。
• 可使用 go clean-modcache 清理全部已緩存的模塊版本數據。

另外在 Go1.11 以後 GOCACHE 已經不容許設置爲 off 了，我想着這也是爲了模塊數據緩存移動位置作準備，所以你們應該儘快作好適配。

++++++++++++++++++++++++=+++++++++++++++++=++++++++++++++++++++++++=+++++++++++++++++=++++++++++++++++++++++++=+++++++++++++++++=++++++++++++++++++++++++=+++++++++++++++++=++++++++++++++++++++++++=+++++++++++++++++=++++++++++++++++++++++++=+++++++++++++++++=++++++++++++++++++++++++=+++++++++++++++++=++++++++++++++++++++++++=+++++++++++++++++=++++++++++++++++++++++++=+++++++++++++++++=++++++++++++++++++++++++=+++++++++++++++++=

快速遷移項目至 Go Modules

• 升級到 Go 1.13。

• 讓 GOPATH 從你的腦海中徹底消失，早一步踏入將來。

  • 修改 GOBIN 路徑（可選）。
  • 打開 Go modules 的開關。
  • 設置 GOPROXY。

• 按照你喜歡的目錄結構從新組織你的全部項目。

• 在你項目的根目錄下執行 go mod init<OPTIONAL_MODULE_PATH> 以生成 go.mod 文件。

• 想辦法說服你身邊全部的人都去走一下前四步。

遷移後 go get 行爲的改變

這裏咱們注意到有兩點比較特別，分別是：

• 第一點：爲何 「拉取 hash 爲 342b231 的 commit，最終會被轉換爲 v0.3.2」 呢。這是由於雖然咱們設置了拉取 @342b2e commit，可是由於 Go modules 會與 tag 進行對比，若發現對應的 commit 與 tag 有關聯，則進行轉換。
• 第二點：爲何不建議使用 go mod vendor，由於 Go modules 正在淡化 Vendor 的概念，頗有可能 Go2 就去掉了。

使用 Go Modules 時常碰見的坑

坑 1: 判斷項目是否啓用了 Go Modules

坑 2: 管理 Go 的環境變量

這裏主要是提到 Go1.13 新增了 go env-w 用於寫入環境變量，而寫入的地方是 os.UserConfigDir 所返回的路徑，須要注意的是 go env-w 不會覆寫。

坑 3: 從 dep、glide 等遷移至 Go Modules

這裏主要是指從舊有的依賴包管理工具（dep/glide 等）進行遷移時，由於 BUG 的緣由會致使不通過 GOPROXY 的代理，解決方法有以下兩個：

• 手動建立一個 go.mod 文件，再執行 go mod tidy 進行補充。
• 上代理，至關於不使用 GOPROXY 了。

坑 4:拉取私有模塊

這裏主要想涉及兩塊知識點，以下：

• GOPROXY 是無權訪問到任何人的私有模塊的，因此你放心，安全性沒問題。
• GOPROXY 除了設置模塊代理的地址之外，還須要增長 「direct」 特殊標識才能夠成功拉取私有庫。

坑 5:更新現有的模塊

坑 6:主版本號

Q：使用 Go modules 時能夠同時依賴同一個模塊的不一樣的兩個或者多個小版本（修訂版本號不一樣）嗎？

A：不能夠的，Go modules 只能夠同時依賴一個模塊的不一樣的兩個或者多個大版本（主版本號不一樣）。好比能夠同時依賴 example.com/foobar@v1.2.3 和 example.com/foobar/v2@v2.3.4，由於他們的模塊路徑（module path）不一樣，Go modules 規定主版本號不是 v0 或者 v1 時，那麼主版本號必須顯式地出如今模塊路徑的尾部。可是，同時依賴兩個或者多個小版本是不支持的。好比若是模塊 A 同時直接依賴了模塊 B 和模塊 C，且模塊 A 直接依賴的是模塊 C 的 v1.0.0 版本，而後模塊 B 直接依賴的是模塊 C 的 v1.0.1 版本，那麼最終 Go modules 會爲模塊 A 選用模塊 C 的 v1.0.1 版本而不是模塊 A 的 go.mod 文件中指明的 v1.0.0 版本。

這是由於 Go modules 認爲只要主版本號不變，那麼剩下的均可以直接升級採用最新的。可是若是採用了最新的結果致使項目 Break 掉了，那麼 Go modules 就會 Fallback 到上一個老的版本，好比在前面的例子中就會 Fallback 到 v1.0.0 版本。