Golang的模块机制是官方推荐的依赖管理方式，规范的版本标签和发布流程是保障模块可维护性的关键。正确的版本标记能让使用者明确模块的兼容性变化，也能让依赖管理工具更精准地拉取对应版本的代码。
Golang模块版本的核心规则
Golang官方推荐使用语义化版本（Semantic Versioning）来标记模块版本，版本号格式为v主版本.次版本.修订版本，每个部分的含义如下：
- 主版本：当做出不兼容的API修改时递增，比如v1.0.0升级到v2.0.0，意味着新版本无法兼容v1版本的调用方式
- 次版本：当做了向下兼容的功能新增时递增，比如v1.1.0新增了某个函数，原有v1.0.0的代码仍可正常运行
- 修订版本：当做了向下兼容的问题修复时递增，比如v1.0.1修复了v1.0.0的某个bug，功能没有新增也没有破坏兼容性
如何为Golang模块打版本标签
版本标签本质是Git的标签，需要结合模块的go.mod文件来操作，具体步骤如下：
1. 确认模块基础信息
首先确保模块根目录下的go.mod文件已经正确声明模块路径，比如：
module github.com/example/mymodule go 1.21
2. 提交当前代码变更
在打标签前，需要把所有要包含在当前版本里的代码变更提交到Git仓库，避免标签指向未提交的代码：
git add . git commit -m "feat: 新增用户查询接口"
3. 打符合规范的版本标签
使用Git命令打标签，标签名必须严格按照语义化版本格式，以v开头：
# 打v1.0.0正式版本标签 git tag v1.0.0 # 推送标签到远程仓库 git push origin v1.0.0
4. 主版本升级的特殊处理
当模块主版本升级到v2及以上时，需要在模块路径中增加主版本后缀，避免和v1版本冲突，修改go.mod文件：
module github.com/example/mymodule/v2 go 1.21
之后再打v2.0.0的标签：
git tag v2.0.0 git push origin v2.0.0
预发布版本和伪版本的使用
除了正式版本，Golang模块还支持预发布版本和伪版本，满足不同的开发场景：
预发布版本
预发布版本用于标记测试版本，格式为v版本号-预发布标识，比如v1.0.0-beta.1、v1.0.0-rc.1，这类版本不会被go get自动升级拉取，需要明确指定版本号才能获取：
git tag v1.0.0-beta.1 git push origin v1.0.0-beta.1
伪版本
如果模块还没有打正式标签，或者需要引用某个特定的提交，Go会生成伪版本，格式为v版本号-时间戳-提交哈希前缀，比如v0.0.0-20240520123456-abcdef123456，这类版本通常用于依赖尚未发布正式版本的模块。
版本发布注意事项
- 同一个版本标签不能重复打，如果打错了需要先删除本地和远程的标签再重新操作
- 主版本升级后，旧版本仍然可以维护，比如可以继续给v1版本打v1.0.1的修订版本标签
- 不要随意修改已经发布的版本标签对应的代码，避免依赖该版本的项目出现不可预期的问题
- 发布版本前建议编写CHANGELOG，说明当前版本的变更内容，方便使用者了解版本差异
常见问题说明
很多开发者会遇到打标签后go get拉取不到版本的情况，通常是因为没有把标签推送到远程仓库，或者标签名不符合规范。可以执行go list -m -versions 模块路径查看当前模块已发布的所有版本：
go list -m -versions github.com/example/mymodule
如果输出为空，说明没有符合规范的已发布版本，需要检查标签是否正确推送且格式无误。