Go.mod版本号规则:语义化版本

基础规则

Go 模块严格遵循语义化版本 ,版本号格式为vX.Y.Z(如v1.9.1),每个部分的含义如下:

  • X(主版本号) :不兼容的 API 变更(如v1→v2,表示有 breaking change,使用时需谨慎);
  • Y(次版本号) :向后兼容的功能新增(如v1.8→v1.9,新增功能但不影响旧代码);
  • Z(修订号) :向后兼容的 bug 修复(如v1.9.0→v1.9.1,仅修复 bug)。

如图

特殊版本标识:

  • 预发布版本:在版本号后加-beta/-rc等(如v1.9.0-beta.1,表示测试版,稳定性未保障);
  • 伪版本:当依赖没有正式版本号(仅 Git 提交记录)时,Go 会生成伪版本(如v0.0.0-20231001123456-abcdef123456,格式:v0.0.0-时间戳-commit哈希)。
  • 不兼容的版本:版本号后自动添加+incompatible标记,表明这是一个 "不兼容的版本"

按照 Go 模块的强制要求:当一个模块的主版本号升级到v2及以上(如v2、v3)时,必须在模块路径中添加版本后缀(如/v2、/v3),例如:

  • v1 版本路径:github.com/avast/retry-go
  • v3 版本正确路径 应该是:github.com/avast/retry-go/v3

但这个依赖的作者在发布v3.0.0时,仍然使用了旧的路径(没有加/v3),导致 Go 模块认为它 "不符合规范"。

如何发布自己的 Go 模块?

如果你开发的包想被其他人通过go get引用,需按以下步骤发布:

  1. 确保模块路径是可访问的 Git 仓库地址 (如github.com/your-username/your-package);
  2. 在 Git 仓库中打语义化版本标签 (如v1.0.0):****
perl 复制代码
git tag v1.0.0
git push origin v1.0.0
  1. 其他人即可通过go get 你的模块路径@版本号引用(如go get github.com/your-username/your-package@v1.0.0)。

(3)主版本号升级(如 v1→v2)需要注意什么?

当你的模块有不兼容的 API 变更(需升级主版本号到 v2),必须修改模块路径 (在路径后加/v2),否则会导致依赖冲突:

  • 示例:v1 版本路径为github.com/your-username/your-package,v2 版本需改为github.com/your-username/your-package/v2;
  • 原因:Go 模块通过 "路径 + 版本号" 唯一标识依赖,v2 路径的变更会让 Go 认为是 "新模块",避免与 v1 版本冲突。
相关推荐
旋律4144 小时前
数据倾斜
后端
泡海椒4 小时前
jquick-pdf 热力图实战:Object 数组三元素的数据契约与模板还原
后端
行百里er4 小时前
【Spring Insight 技术分享】如何给 AI 接口调用做滑动窗口限流
spring boot·后端·spring cloud
贾公子4 小时前
异步检测的轮询与超时——别把「还没好」当成「失败了」
后端·python
im_AMBER5 小时前
CDC 对账:数据同步之后,如何验证源库与目标库一致
后端·mysql·面试
vlans5 小时前
Go:用装饰器给通知发送加上日志
后端·架构
王丁炜5 小时前
AI 产品死在第二十个问题上,不是死在模型上
后端
bai2735 小时前
同一条 294 字符的路径:Node 走得进去,git add 直接 exit 128
javascript·后端
一条Go6 小时前
探测规则:为什么它是告警规则的一种,而不是独立的任务体系
后端·架构·github