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 命令:
立即学习“go语言免费学习笔记(深入)”;
- 提交当前更改:
git add . && git commit -m "准备发布 v1.1.0" - 打标签:
git tag v1.1.0 - 推送到远程仓库:
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 库就能被其他项目顺利引用和管理。










