Go语言从1.11版本引入模块机制后，模块版本号成为管理项目依赖的核心标识，理解版本号的查看方式和语义化规则，能有效避免依赖冲突，提升项目稳定性。
如何查看Go模块版本号
查看Go模块版本号有多种常用方式，可根据不同场景选择：
1. 查看go.mod文件
项目的go.mod文件会记录直接依赖的模块及版本号，打开文件后找到require块即可查看，示例如下：
module example_project
go 1.21
require (
github.com/gin-gonic/gin v1.9.1
golang.org/x/text v0.14.0
)
上述代码中v1.9.1、v0.14.0就是对应模块的版本号。
2. 使用go命令查看
执行go list -m all命令可以列出当前项目所有依赖模块及版本号，包括间接依赖：
go list -m all # 输出示例 example_project github.com/gin-gonic/gin v1.9.1 github.com/go-playground/validator/v10 v10.19.0 golang.org/x/text v0.14.0
如果只需要查看指定模块的版本，可以执行go list -m 模块路径：
go list -m github.com/gin-gonic/gin # 输出示例 github.com/gin-gonic/gin v1.9.1
Go语义化版本规则解析
Go模块版本号遵循语义化版本2.0.0规范，标准格式为v主版本号.次版本号.修订号，部分版本还会带有预发布标识和构建元数据。
版本号核心字段含义
| 字段 | 说明 | 示例 |
|---|---|---|
| 主版本号 | 当做了不兼容的API修改时递增，主版本号大于1时，需要在模块路径中添加对应版本后缀，比如v2版本路径为github.com/xxx/yyy/v2 | v2.0.0中的2 |
| 次版本号 | 当做了向下兼容的功能新增时递增 | v1.9.0中的9 |
| 修订号 | 当做了向下兼容的问题修复时递增 | v1.9.1中的1 |
特殊版本标识
- 预发布版本：版本号后可以添加连字符和预发布标识，比如
v1.9.1-beta.1、v2.0.0-rc.1，预发布版本优先级低于对应的正式版本。 - 构建元数据：版本号后可以添加加号和构建信息，比如
v1.9.1+20240520，构建元数据仅用于标识构建信息，不影响版本优先级。 - 伪版本：当依赖的模块没有打正式标签时，Go会自动生成伪版本号，格式为
v0.0.0-时间戳-提交哈希，比如v0.0.0-20240520123456-abcdef123456。
版本兼容性规则
Go模块的版本兼容性遵循以下逻辑：
- 主版本号相同的情况下，高次版本号、高修订号的版本可以兼容低次版本号、低修订号的版本，比如v1.9.1兼容v1.8.0、v1.9.0。
- 主版本号不同的模块属于不同的模块，比如
github.com/xxx/yyy/v1和github.com/xxx/yyy/v2是两个完全独立的模块，可以同时依赖。
版本号使用注意事项
在实际开发中需要注意以下版本号相关的问题：
- 主版本号为0的模块（如v0.1.0）属于不稳定版本，API可能随时发生不兼容修改，生产环境使用需要谨慎评估。
- 升级依赖时，优先选择修订号升级的版本，这类版本通常只包含问题修复，兼容性风险最低；次版本号升级需要确认新增功能是否影响现有逻辑；主版本号升级需要重点做兼容性测试。
- 不要手动修改
go.mod中的版本号，建议使用go get 模块路径@版本号命令来升级或降级依赖，Go会自动处理相关依赖关系。
示例：升级gin模块到v1.9.1版本：
go get github.com/gin-gonic/gin@v1.9.1
理解Go模块版本号的查看方式和语义化规则，能帮助开发者更规范地管理项目依赖，减少因版本不兼容导致的问题，提升项目的可维护性。