2019年9月26日: Go生态洞察：发布Go模块

2019年9月26日: Go生态洞察：发布Go模块 🚀

摘要

🐯 猫头虎博主在此，带你深入Go的奥秘！今天我们探讨Go模块的发布。围绕着Tyler Bui-Palsulich的经典教程，我们会一步步学习如何有效地发布你的Go模块。🌟 让我们开始这次技术之旅吧！

引言

这篇文章是关于Go模块系列教程的第三部分，旨在帮助你了解如何编写和发布Go模块。

• 第1部分 — 使用Go模块
• 第2部分 — 迁移到Go模块
• 第3部分 — 发布Go模块 (本文)
• 第4部分 — Go模块：v2及以后
• 第5部分 — 保持模块兼容性

正文

📦 项目设置

首先，你需要一个现有项目来作为例子。可以使用使用Go模块文章结尾处的文件：

// go.mod
module example.com/hello
go 1.12
require rsc.io/quote/v3 v3.1.0
// 更多代码...

🏷️ 语义版本和模块

每个go.mod文件中的模块都有一个语义版本，格式为vMAJOR.MINOR.PATCH。这个版本号反映了模块的公共API的向后兼容性。

🚧 v0：初始不稳定版本

使用v0版本开始你的项目，它不提供稳定性保证。这里是给模块打标签的步骤：

$ go mod tidy
$ go test ./...
$ git tag v0.1.0
$ git push origin v0.1.0

🔐 v1：第一个稳定版本

一旦你确定模块的API稳定，可以发布v1.0.0。这表明你不会对模块的API进行不兼容的更改。

$ go mod tidy
$ go test ./...
$ git tag v1.0.0
$ git push origin v1.0.0

📊 表格总结知识要点

总结

在本篇中，我们深入探讨了如何发布Go模块，从v0到v1的迁移。感谢阅读猫头虎的Go生态洞察专栏！更多精彩内容，点击这里。

参考资料

• Tyler Bui-Palsulich, “Publishing Go Modules”, 2019年9月26日.
• Go官方博客