大家好，我是煎魚。

Go 的依賴管理，也就是 Go Module。從推出到現(xiàn)在，也已經(jīng)有了一定的年頭了，吐槽一直很多，官方也不斷地在進(jìn)行完善。

Go1.18 將會(huì)推出一個(gè)新特性：Multi-Module Workspaces，用于支持 Module 多工作區(qū)，能解決以往的一系列問題。

今天將由煎魚帶大家一起深入學(xué)習(xí)。

背景

在日常使用 Go 工程時(shí)，總會(huì)遇到 2 個(gè)經(jīng)典問題，特別的折騰人。

如下：

1. 依賴本地 replace module。
2. 依賴本地未發(fā)布的 module。

replace module

第一個(gè)場(chǎng)景：像是平時(shí)在 Go 工程中，我們?yōu)榱私鉀Q一些本地依賴，或是定制化代碼。會(huì)在 go.mod 文件中使用 replace 做替換。

如下代碼：

replace golang.org/x/net => /Users/eddycjy/go/awesomeProject

這樣就可以實(shí)現(xiàn)本地開發(fā)聯(lián)調(diào)時(shí)的準(zhǔn)確性。

問題就在這里：

• 本地路徑：所設(shè)定的 replace 本質(zhì)上轉(zhuǎn)換的是本地的路徑，也就是每個(gè)人都不一樣。
• 倉庫依賴：文件修改是會(huì)上傳到 Git 倉庫的，不小心傳上去了，影響到其他開發(fā)同學(xué)，又或是每次上傳都得重新改回去。

用戶體驗(yàn)非常差，很折騰人。

未發(fā)布的 module

第二個(gè)場(chǎng)景：在做本地的 Go 項(xiàng)目開發(fā)時(shí)，可能會(huì)在本地同時(shí)開發(fā)多個(gè)庫(項(xiàng)目庫、工具庫、第三方庫)等。

如下代碼：

package main

import (
    "github.com/eddycjy/pkgutil"
)

func main() {
    pkgutil.PrintFish()
}

如果這個(gè)時(shí)候運(yùn)行 go run 或是 go mod tidy，都不行，會(huì)運(yùn)行失敗。

報(bào)如下類似錯(cuò)誤：

fatal: repository 'https://github.com/eddycjy/pkgutil/' not found

這個(gè)問題報(bào)錯(cuò)是因?yàn)?github.com/eddycjy/pkgutil這個(gè)庫，在 GitHub 是沒有的，自然也就拉取不到。

解決方法：在 Go1.18 以前，我們會(huì)通過 replace(會(huì)遇到背景一的問題)，又或是直接上傳到 Github 上，自然也就能被 Go 工具鏈拉取到依賴了。

許多同學(xué)會(huì)發(fā)出靈魂質(zhì)疑：Go 的依賴都必須要上傳到 GitHub 嗎，強(qiáng)綁定?

對(duì)新入門的同學(xué)非常不友好，很要命。

工作區(qū)模式

在社區(qū)的多輪反饋下，Michael Matloob 提出了提案《Proposal: Multi-Module Workspaces in cmd/go[1]》進(jìn)行了大量的討論和實(shí)施，在 Go1.18 正式落地。

新提案的一個(gè)核心概念，就是增加了 go work 工作區(qū)的概念，針對(duì)的是 Go Module 的依賴管理模式。

其能夠在本地項(xiàng)目的 go.work 文件中，通過設(shè)置一系列依賴的模塊本地路徑，再將路徑下的模塊組成一個(gè)當(dāng)前 Go 工程的工作區(qū)，也就是 N 個(gè) Go Module 組成 1 個(gè) Go Work， 工作區(qū)的讀取優(yōu)先級(jí)是最高的。

我們可以通過 go help 來查看，如下：

$ go1.18beta1 help work
Usage:

 go work <command> [arguments]

The commands are:

 edit        edit go.work from tools or scripts
 init        initialize workspace file
 sync        sync workspace build list to modules
 use         add modules to workspace file

Use "go help work <command>" for more information about a command.

只要執(zhí)行 go work init 就可以初始化一個(gè)新的工作區(qū)，后面跟的參數(shù)就是要生成的具體子模塊 mod。

命令如下：

go work init ./mod ./tools
項(xiàng)目目錄如下：

項(xiàng)目目錄如下：

awesomeProject
├── mod
│   ├── go.mod      // 子模塊
│   └── main.go
├── go.work         // 工作區(qū)
└── tools
    ├── fish.go
    └── go.mod      // 子模塊

生成的 go.work 文件內(nèi)容：

go 1.18

use (
    ./mod 
    ./tools
)

新的 go.work 與 go.mod 語法一致，也可以使用 replace 語法：

go 1.18

use (...)

replace golang.org/x/net => example.com/fork/net v1.4.5

• go.work 文件內(nèi)共支持三個(gè)指令：
• go：聲明 go 版本號(hào)，主要用于后續(xù)新語義的版本控制。
• use：聲明應(yīng)用所依賴模塊的具體文件路徑，路徑可以是絕對(duì)路徑或相對(duì)路徑，可以在應(yīng)用命目錄外均可。

replace：聲明替換某個(gè)模塊依賴的導(dǎo)入路徑，優(yōu)先級(jí)高級(jí) go.mod 中的 replace 指令。

若想要禁用工作區(qū)模式，可以通過 -workfile=off指令來指定。

也就是在運(yùn)行時(shí)執(zhí)行如下命令：

go run -workfile=off main.go

go build -workfile=off

go.work 文件是不需要提交到 Git 倉庫上的，否則就比較折騰了。

只要你在 Go 項(xiàng)目中設(shè)置了 go.work 文件，那么在運(yùn)行和編譯時(shí)就會(huì)進(jìn)入到工作區(qū)模式，會(huì)優(yōu)先以工作區(qū)的配置為最高優(yōu)先級(jí)，來適配本地開發(fā)的訴求。

至此，工作區(qū)的核心知識(shí)就介紹完畢了。

總結(jié)

今天給大家介紹了 Go1.18 的新特性：多 Module 工作區(qū)模式。其本質(zhì)上還是為了解決本地開發(fā)的訴求。

由于 go.mod 文件是與項(xiàng)目強(qiáng)關(guān)聯(lián)的，基本都會(huì)上傳到 Git 倉庫中，很難在這上面動(dòng)刀子。直接就造了個(gè) go.work 出來，純本地使用，方便快捷。

使用新的 go.work，就可以在完全是本地文件上各種搗鼓了，不會(huì)對(duì)其他成員開發(fā)有其他影響。

你覺得怎么樣呢?：)

參考資料

[1]Proposal: Multi-Module Workspaces in cmd/go: https://go.googlesource.com/proposal/+/master/design/45713-workspace.md