在 Golang 项目使用 GitHub fork 出来的项目(go mod 的 replace)

BonjourDurant于 2021-11-19 16:09:46 发布329 收藏 1

文章标签： golang github

版权

今天从 GitHub 克隆了一个别人的 Golang Markdown 项目，作了些修改，想使用自己的版本，发现不行，因为模块的路径不对，导致导入出错。

原来的模块路径和文件(go.mod)：

• github.com/yuin/goldmark

  1.  
     module github.com/yuin/goldmark
  2.  
      
  3.  
     go 1.13

克隆后的模块路径和文件：

• github.com/movsb/goldmark

  1.  
     module github.com/yuin/goldmark
  2.  
      
  3.  
     go 1.13

只是路径变了，go.mod 里面的内容是不变的。

同样，代码里面使用的当前项目的子模块的引用路径肯定也没变。这样一定会导致各种引用混乱。所以当前 Go 语言为什么没有引入导入相对路径的模块？🤔

尝试在测试项目里面使用我自己的克隆版本：

1.  
   package main
2.  
    
3.  
   import "github.com/movsb/goldmark"
4.  
    
5.  
   func main() {
6.  
   goldmark.New()
7.  
   }

发现会报错：

1.  
   $ go run main.go
2.  
   go: github.com/movsb/goldmark: github.com/movsb/goldmark@v1.1.30: parsing go.mod:
3.  
   module declares its path as: github.com/yuin/goldmark
4.  
   but was required as: github.com/movsb/goldmark

所以，怎么办？不可能把人家的路径全部给改了吧？

突然想到了 replace 指令。

以前为了引入一个在本地正在开发的模块，经常 replace 路径为本地路径：

replace github.com/movsb/taorm => /Users/tao/code/taorm

实际上 replace 也可以用来替换掉非本地的模块路径。

代码里面导入原来的仓库路径：

1.  
   package main
2.  
    
3.  
   import "github.com/yuin/goldmark"
4.  
    
5.  
   func main() {
6.  
   goldmark.New()
7.  
   }

go.mod 里面 replace 掉。require 原来的，replace 成自己的：

1.  
   module github.com/movsb/test
2.  
    
3.  
   require github.com/yuin/goldmark v1.1.30
4.  
    
5.  
   replace github.com/yuin/goldmark => github.com/movsb/goldmark v1.1.30
6.  
    
7.  
   go 1.13

如果要更新版本，可以把 v1.1.30 换成新版本，或者 git 的提交号（commit-id），然后在终端执行：

go mod download github.com/movsb/goldmark@版本号或提交号

注意前端的版本号是用空格分开的，命令中的版本号是用@分开的。

参考：

• When should I use the replace directive?
• go modules的replace使用, 解决fork的项目import问题

原文地址：