Go 1.13多包项目迁移至Module(v5)：目录结构与编译问题求助

兄弟，我刚帮你梳理了Go Module迁移到v5版本的这些坑，一步步给你讲清楚：

1. 正确的目录结构（关键！） #

首先要明确：Go Module是按仓库级进行版本化的，不是单个包。所以当版本≥v2时，模块路径必须带版本后缀（比如github.com/你的用户名/你的仓库名/v5），对应的目录结构应该是：

<reponame>
├── v5
│   ├── go.mod
│   ├── p1
│   │   ├── p1a.go
│   │   └── p1b.go
│   ├── p2
│   │   ├── p2a.go
│   │   └── p2b.go
│   └── examples  # 可选：把示例放在模块内
│       └── e1.go
└── examples      # 可选：把示例作为独立模块
    └── go.mod
    └── e1.go

绝对不能搞成<repo>/p1/v5这种单个包加版本的结构，因为Go Module的版本是针对整个模块（仓库）的，不是单个包。

2. go.mod的正确配置 #

（1）v5模块的go.mod（核心） #

进入v5目录，运行go mod init github.com/你的用户名/你的仓库名/v5，生成的go.mod内容应该是：

module github.com/你的用户名/你的仓库名/v5

go 1.13

这个go.mod会覆盖p1、p2两个包，它们的导入路径分别是github.com/你的用户名/你的仓库名/v5/p1和github.com/你的用户名/你的仓库名/v5/p2。

（2）示例程序的两种配置方式 #

• 方式一：示例作为v5模块的一部分
  把examples文件夹放到v5目录下，e1.go里直接导入github.com/你的用户名/你的仓库名/v5/p1和github.com/你的用户名/你的仓库名/v5/p2，不需要额外的go.mod，直接在v5目录下运行go run examples/e1.go就能测试。

• 方式二：示例作为独立模块
  把examples留在仓库根目录，进入examples目录运行go mod init github.com/你的用户名/你的仓库名/examples，然后修改go.mod：

  module github.com/你的用户名/你的仓库名/examples
  
  go 1.13
  
  require github.com/你的用户名/你的仓库名/v5 v5.0.0
  
  // 本地测试用replace指向本地v5目录
  replace github.com/你的用户名/你的仓库名/v5 => ../v5
  

  这样在examples目录下运行go run e1.go就会使用本地的v5代码，不会去GitHub找已发布的版本。

3. 解决本地测试"no matching versions for query 'v5'"的问题 #

你遇到的报错本质是Go默认会去远程仓库找已发布的v5版本，但你还没推送标签。解决办法就是用replace指令强制指向本地目录，注意这几点：

• 如果示例是独立模块，replace的路径要写对（比如上面的../v5，根据你的目录层级调整）
• 如果示例在v5模块内，直接在v5目录下运行命令即可，不需要replace，因为Go会优先使用本地模块上下文
• 测试时确保你在正确的目录下：比如测试模块内的示例，就进入v5目录；测试独立示例，就进入examples目录

另外，提前给你说下发布步骤：等本地测试没问题后，在仓库根目录打v5版本标签：git tag v5.0.0，然后git push origin v5.0.0，这样远程仓库就有v5版本了，后续别人依赖的时候就能正常拉取。

内容的提问来源于stack exchange，提问作者Mark Taylor