关于golang:Go-mod-replace-使用

98次阅读

共计 1723 个字符,预计需要花费 5 分钟才能阅读完成。

日常开发离不开第三方库,大部分的时候,这些库都是满足咱们的须要,但有的时候,咱们须要 fork 一份,做一些批改。go mod 作为以后 go 语言的官网包管理器,天然也思考到了这种状况。在 go.mod 文件中,通过 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 命令执行后,会主动生成 go.mod 文件,该文件中,列出了我的项目所依赖的第三方包,以及所应用的版本。

而后执行 go mod tidy,该命令做两件事:

  1. 解析我的项目文件,并找到所应用的包
  2. 生成 go.sum 文件,其中保留了所应用包的版本

而后执行 go run main.go,来执行我的项目。

当初,我的项目应该曾经能够失常执行,并返回执行后果了。

假如咱们此时想调用一个过滤字符串中,HTML 标签的办法,但翻了一下并没有,于是 fork 了一份这个库,咱们本人增加了进去:

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

上面咱们来看如何调用这个新的办法。

第一种形式:

  1. fork strutil 库,关上 go.mod 文件,将第一行中的 module name 批改为一个新的 name
  2. 减少所须要的办法
  3. 减少新的 git tag
  4. 在你以后我的项目中,援用你批改后的这个 repo,替换地址以及版本号

这种形式相当于援用了一个新的库,与之前那个库曾经没有什么关系了。大多数时候,因为对代码批改过多,咱们并不会想要这么用。go mod 当然也思考到了这一点,go mod 提供了 go mod replace 办法来应答这种场景。

第二种形式:

  1. fork strutil 库
  2. 减少所须要的办法
  3. 在以后我的项目中,执行 go mod edit -replace 命令:
go mod edit -replace [old git package]@[version]=[new git package]@[version]

执行完命令后,咱们关上 go.mod 文件,发现最上面多了一条指令:

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 指令,将对应的版本号替换成这个,而后再次执行,就能够应用咱们本人 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 语句给删除掉,这种形式没有毁坏原有的代码。

正文完
 0