如何给Golang库打tag_Golang语义化版本标记说明

Go模块打tag应遵循语义化版本规范vMAJOR.MINOR.PATCH，如v1.2.3；主版本号递增表示不兼容API变更，次版本号递增表示向后兼容新增功能，修订号递增表示向后兼容问题修复；需加v前缀，v0.x.y为不稳定版，v1.0.0起保证API稳定，v2+须在模块路径中显式包含版本号。

给Go模块打tag时，遵循语义化版本（Semantic Versioning，简称 SemVer）是社区标准做法。Go 工具链会根据你 Git 仓库中的 tag 来解析和下载对应版本的库，因此正确标记版本非常重要。

什么是语义化版本？

语义化版本格式为：MAJOR.MINOR.PATCH，例如 v1.2.3：

• MAJOR：主版本号，当你做了不兼容的 API 修改时递增
• MINOR：次版本号，当你以向后兼容的方式添加新功能时递增
• PATCH：修订号，当你进行向后兼容的问题修复时递增

版本前要加 v 前缀，如 v1.0.0，这是 Go 模块推荐的做法。

如何为 Golang 库打 tag

在你的项目根目录（包含 go.mod 文件的目录）执行以下 Git 命令：

1. 提交当前更改：
   git add . && git commit -m "准备发布 v1.1.0"
2. 打标签：
   git tag v1.1.0
3. 推送到远程仓库：
   git push origin v1.1.0

你也可以使用带注释的标签：

git tag -a v1.1.0 -m "发布版本 1.1.0：新增配置加载功能"

Go 模块与版本规则

Go 模块对版本有明确行为：

• 版本 v0.x.y 被视为不稳定版本，API 可能随时变化
• 版本 v1.0.0 起表示稳定 API，应保持向后兼容
• 从 v2 开始，如果 API 不兼容，必须在模块路径中包含版本，如：
  module example.com/mylib/v2

未遵循此规则可能导致依赖者无法正确导入。

建议的最佳实践

• 每次发布正式版本都打一个 tag
• 确保 tag 对应的代码是经过测试、可构建的
• 在 CHANGELOG 中记录版本变更内容
• 使用 GitHub Releases 功能关联 tag 和发布说明

基本上就这些。只要坚持用 vMAJOR.MINOR.PATCH 格式打 tag，并遵守语义化版本规则，你的 Go 库就能被其他项目顺利引用和管理。