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

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

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

• github.com/yuin/goldmark

  module github.com/yuin/goldmark
  
  go 1.13
  

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

• github.com/movsb/goldmark

  module github.com/yuin/goldmark
  
  go 1.13
  

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

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

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

package main

import "github.com/movsb/goldmark"

func main() {
	goldmark.New()
}

发现会报错：

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

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

突然想到了 replace 指令。

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

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

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

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

package main

import "github.com/yuin/goldmark"

func main() {
	goldmark.New()
}

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

module github.com/movsb/test

require github.com/yuin/goldmark v1.1.30

replace github.com/yuin/goldmark => github.com/movsb/goldmark v1.1.30

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问题