引言

日常開發(fā)離不開第三方庫，大部分的時候，這些庫都是滿足我們的需要，但有的時候，我們需要 fork 一份，做一些修改。

go mod 作為當前 go 語言的官方包管理器，自然也考慮到了這種情況。

在 go.mod 文件中，通過 replace 指令，將舊的庫地址，替換為新的庫地址來實現(xiàn)這一操作。

go replace 的使用

下面通過一個示例來講解 go replace 的使用，以及常見問題的處理。

我們首先新建一個項目，并在其中引用 ozgio/strutil: String utilities for Go (github.com) 這個字符串處理庫，然后隨便寫段代碼，確保其可以正常工作：

package main
import (
    "fmt"
    "github.com/ozgio/strutil"
)
func main() {
    fmt.Println(strutil.Align("lorem ipsum", strutil.Right, 20))
}

go mod 的初始化

go mod init project_name

go mod init 命令執(zhí)行后，會自動生成 go.mod 文件，該文件中，列出了項目所依賴的第三方包，以及所使用的版本。

然后執(zhí)行 go mod tidy，該命令做兩件事：

• 解析項目文件，并找到所使用的包
• 生成 go.sum 文件，其中保存了所使用包的版本

然后執(zhí)行 go run main.go，來執(zhí)行項目。

現(xiàn)在，項目應該已經(jīng)可以正常執(zhí)行，并返回執(zhí)行結果了。

假設我們此時想調用一個過濾字符串中，HTML 標簽的方法，但翻了一下并沒有，于是 fork 了一份這個庫，我們自己添加了進去：

https://github.com/shiweifu/strutil/blob/master/escape.go

調用新的方法

下面我們來看如何調用這個新的方法。

第一種方式：

• fork strutil 庫，打開 go.mod 文件，將第一行中的 module name 修改為一個新的 name
• 增加所需要的方法
• 增加新的 git tag
• 在你當前項目中，引用你修改后的這個 repo，替換地址以及版本號

這種方式相當于引用了一個新的庫，與之前那個庫已經(jīng)沒有什么關系了。大多數(shù)時候，因為對代碼修改過多，我們并不會想要這么用。go mod 當然也考慮到了這一點，go mod 提供了 go mod replace 方法來應對這種場景。

第二種方式：

• fork strutil 庫
• 增加所需要的方法
• 在當前項目中，執(zhí)行 go mod edit -replace 命令：

go mod edit -replace [old git package]@[version]=[new git package]@[version]

執(zhí)行完命令后，我們打開 go.mod 文件，發(fā)現(xiàn)最下面多了一條指令：

replace github.com/ozgio/strutil v0.3.0 => github.com/shiweifu/strutil v0.3.0

go mod replace 指令支持指定版本號，可以為 git tag，也可以為 git commit 日期 + git commit hash 的組合。

可以通過以下指令，來獲取某個分支的最新版本：

go get github.com/shiweifu/strutil@master

此時會輸出 master 分支的最新 commit 記錄：

github.com/shiweifu/strutil@v0.3.1-0.20210615145512-3bd39e22cb0d

把這段版本號復制到 go.mod 文件replace 指令，將對應的版本號替換成這個，然后再次執(zhí)行，就可以使用我們自己 fork 的 strutil 了：

package main
import (
    "fmt"
    "github.com/ozgio/strutil"
)
func main() {
    out := strutil.EscapeHTMLTag("<script>abc</script>")
    fmt.Println(out)
}

我們引用的還是 github.com/ozgio/strutil 這個庫，而 EscapeHTMLTag 是我們新添加的方法，這種方式只是對 go.mod 進行了修改，然后我們可以對 ozgio/strutil 提一個 pr，如果我們的代碼被合并進倉庫，我們可以把 replace 語句給刪除掉，這種方式?jīng)]有破壞原有的代碼。

以上就是Go mod replace使用方法示例的詳細內容，更多關于Go mod replace的資料請關注腳本之家其它相關文章！

最新評論