如何将主要版本的 Go Module 替换为 fork @ master

Question

我在使用带有/v2 / 主要版本映射的项目的 go.mod 的任何固定分支映射分叉时遇到问题。

我有以下 go.mod：

go 1.18

require (
    github.com/versent/saml2aws/v2 v2.35.0
)

注意该模块需要/v2 ，否则它会得到v2.17.0+incompatible 。

1. 我在这里分叉了这个项目： https ://github.com/marcottedan/saml2aws
2. 我在这里创建了一个分支add-aad-entropy-PhoneAppNotification ： https://github.com/marcottedan/saml2aws/tree/add-aad-entropy-PhoneAppNotification ://github.com/marcottedan/saml2aws/tree/add-aad-entropy-PhoneAppNotification
3. 我尝试修改或不修改我的 fork go mod 中 go.mod 的第一行，从module github.com/versent/saml2aws/v2到module github.com/marcottedan/saml2aws/v2

我正在使用以下指令，但没有一个有效：

这会下载我 fork 的标签2.35.0 ，即使我要求它获取master

dmarcotte@dmarcottes% go get -d github.com/marcottedan/saml2aws/v2@master
go: downloading github.com/marcottedan/saml2aws/v2 v2.35.0
go: github.com/marcottedan/saml2aws/v2@v2.35.0: parsing go.mod:
        module declares its path as: github.com/versent/saml2aws/v2
                but was required as: github.com/marcottedan/saml2aws/v2

我还尝试修改我的go.mod ：

replace github.com/versent/saml2aws/v2 => github.com/marcottedan/saml2aws/v2 v2.35.0

-> Can't find a way to target master with the /v2 pattern

如果我放弃 /v2 并使用 @master，它并不关心并获取 v1 中的最新标签（在 saml2aws 迁移到 go mod 之前，它被命名为 2.17.0+incompatible）

dmarcotte@dmarcottes % go get -d github.com/marcottedan/saml2aws@master   
go: github.com/marcottedan/saml2aws@master: github.com/marcottedan/saml2aws@v1.8.5-0.20220520001825-f05a14a2b3f2: invalid version: go.mod has post-v1 module path "github.com/marcottedan/saml2aws/v2" at revision f05a14a2b3f2

我在这里很迷茫。

Answer 1

经过大量挖掘，以下是我发现似乎有效的步骤：

1. 创建任何项目的分支
2. 将go.mod第一行更改为您的新分叉名称，提交和推送
3. 在分支或主控中提交并推送您需要的任何更改
4. 在您的原始项目中，执行以下命令： go get -d -u github.com/marcottedan/saml2aws/v2@master其中@version 是您的分支名称。
5. 在您的go.mod中，添加以下替换指令： replace github.com/versent/saml2aws/v2 v2.35.0 => github.com/marcottedan/saml2aws/v2 master
6. 每次在 fork 中推送提交时，重复第 4 步。

最后你的 go.mod 应该是这样的：

module <yourname>

go 1.18

require (
    github.com/versent/saml2aws/v2 v2.35.0
)

replace github.com/versent/saml2aws/v2 v2.35.0 => github.com/marcottedan/saml2aws/v2 master

请注意，如果您只是单独工作，则可以使用 replace 指令映射驱动器上的本地文件夹。 但这往往不适用于队友，因为他们在提取代码时还必须检查相同的确切分叉路径。 这是一个例子：

module <yourname>

go 1.18

require (
    github.com/versent/saml2aws/v2 v2.35.0
)

replace github.com/versent/saml2aws/v2 => /Users/dmarcotte/git/saml2aws/