什么是语义化版本(SemVer)?Composer如何依赖它工作?(版本号解析)

2次阅读

语义化版本(SemVer)用M.N.P三位数字约定版本含义:M为不兼容API变更,N为向后兼容新增功能,P为纯修复;composer据此解析如^2.8等约束,自动选择安全更新范围。

什么是语义化版本(SemVer)?Composer如何依赖它工作?(版本号解析)

语义化版本(SemVer)是一套用三位数字(主版本.次版本.修订号,如 2.4.1)表达版本演进含义的约定,不是随便编的编号。Composer 依赖它自动判断哪些更新是安全的、哪些可能破坏代码。

版本号背后的含义:每个数字代表什么变化

一个 SemVer 版本形如 M.N.P(例如 3.1.0),三个数字有明确职责:

  • M(主版本号):不兼容的 API 变更。比如移除函数、改方法签名、重命名类——升级后代码大概率报错。
  • N(次版本号):新增向后兼容的功能。加了新方法、新类,但旧代码照常运行。
  • P(修订号):纯修复,比如修 bug、优化性能,完全不影响接口行为。

Composer 怎么用它做依赖决策?

当你在 composer.json 中写 "monolog/monolog": "^2.8",Composer 不是简单找最新版,而是按 SemVer 规则算出“允许安装的范围”:

  • ^2.8 表示:主版本必须是 2,次版本 ≥ 8,修订号任意 —— 即 2.8.02.99.99 都行,但 3.0.0 不允许(主版本变了)。
  • ~2.8.0 更保守:允许 2.8.x,但不允许 2.9.0(次版本也不能升)。
  • 2.8.* 等价于 2.8.0 - 2.8.999,只允许修订号变动。

Composer 安装时会查包的 composer.json 中声明的 version 字段(或 git tag),严格按 SemVer 解析,再比对你的约束条件,选一个满足规则且最新的可用版本。

为什么这很重要?举个真实场景

假设你用 symfony/http-kernel5.4.0,项目里调用了 Kernel::handle() 方法。某天它发布 6.0.0,把 handle() 改成 handleWithException() 并删掉旧方法。如果你的依赖写的是 ^5.4,Composer 死也不会装 6.0.0;但如果误写成 *>=5.4,更新就直接崩。

反过来,如果它发了 5.4.1 修了个请求头解析的 bug,^5.4 会自动拉取,你不用改代码就能受益。

小提醒:不是所有包都守规矩

SemVer 是约定,不是强制标准。有些包可能:

  • 跳着发版(比如从 1.0.0 直接到 3.0.0),或
  • patch 版里偷偷改行为(违反 SemVer),或
  • 根本没打 Git tag,靠 Composer 自己猜版本(不推荐)。

所以看包文档、留意 CHANGELOG、优先选知名库,比光看数字更重要。

基本上就这些。版本号不是密码,是沟通协议 —— 你告诉 Composer 你愿意承担多大风险,它帮你守住边界。

text=ZqhQzanResources