2019年8月21日 Go生态洞察：迁移到Go模块

2019年8月21日 Go生态洞察：迁移到Go模块 🌐

摘要

🐯 嗨，猫头虎博主在此！今天我们将探索2019年8月21日发布的Go生态系列文章的第二部分，专注于迁移到Go模块。Go模块是Go 1.11中引入的官方依赖管理解决方案，本文将详细介绍如何将项目转换为模块。无论您是初次接触Go模块还是寻求深入理解，这篇文章都将为您提供宝贵的洞见。🔍

引言

🔎 Go模块系统为Go项目提供了内置于go命令的官方依赖管理。这篇文章，作为系列的第二部分，将深入讲解如何将Go项目迁移到模块系统，包括不同项目状态的迁移策略。

正文

项目迁移概览 🔄

Go项目在开始转换到模块时可能处于三种状态之一：

• 全新的Go项目。
• 使用非模块依赖管理器的成熟Go项目。
• 没有任何依赖管理器的成熟Go项目。

本文将主要关注后两种情况的迁移过程。

使用依赖管理器的项目 🧰

对于已经使用依赖管理工具的项目，可以通过以下命令进行转换：

$ git clone https://github.com/my/project
[...]
$ cd project
$ go mod init github.com/my/project
go: creating new go.mod: module github.com/my/project
go: copying requirements from Godeps/Godeps.json
$ cat go.mod
module github.com/my/project

go 1.12

require rsc.io/binaryregexp v0.2.1-0.20190524193500-545cabda89ca
$

go mod init将创建一个新的go.mod文件，并自动从Godeps.json、Gopkg.lock或其他支持的格式导入依赖项。

没有依赖管理器的项目 📦

对于没有依赖管理系统的Go项目，首先要创建一个go.mod文件：

$ git clone https://go.googlesource.com/blog
[...]
$ cd blog
$ go mod init golang.org/x/blog
go: creating new go.mod: module golang.org/x/blog
$ cat go.mod
module golang.org/x/blog

go 1.12
$

接下来，运行go mod tidy以添加模块的依赖项。

测试和发布 🚀

迁移到模块后，确保代码构建和测试通过是非常重要的。一些测试可能需要在模块模式下进行调整。最后，您应该为新模块标记并发布一个版本。这是可选的，但没有官方发布，下游用户将依赖于特定提交。

总结

🎯 转换为Go模块对大多数用户来说应该是一个直接的过程。偶尔可能会因非规范导入路径或依赖项中的重大更改而出现问题。未来的文章将探讨发布新版本、v2及以上版本的模块，以及调试奇怪情况的方法。

🔗 本文被猫头虎的Go生态洞察专栏收录，详情点击这里。

参考资料

1. Jean de Klerk, “Migrating to Go Modules”, 21 August 2019.
2. Go官方博客: https://go.dev/blog.