详解 composer 中的版本约束符号（^, ~, *）

^允许主版本不变的向后兼容更新，~限制更严格的次版本内更新，*用作通配符但需谨慎使用以避免不兼容风险。

在使用 Composer 管理 PHP 项目依赖时，版本约束（version constraints）决定了可以安装的包的版本范围。正确理解 ^、~ 和 * 这些符号，有助于控制依赖更新行为，避免意外引入不兼容的更改。

1. 插头符号 ^：遵循语义化版本的向后兼容更新

^ 是最常用的版本约束符，表示允许安装与指定版本兼容的最新版本，前提是不改变主版本号（Major version）。

它基于 语义化版本（SemVer） 规则：版本格式为 主版本.次版本.修订版本（如 2.3.4），其中：

• 主版本（Major）：重大变更，可能包含不兼容的修改
• 次版本（Minor）：新增功能，向后兼容
• 修订版本（Patch）：修复 bug，向后兼容

使用 ^ 时，Composer 允许更新次版本和修订版本，但不会升级主版本。

示例：

Python精要参考 pdf版

这本书给出了一份关于python这门优美语言的精要的参考。作者通过一个完整而清晰的入门指引将你带入python的乐园，随后在语法、类型和对象、运算符与表达式、控制流函数与函数编程、类及面向对象编程、模块和包、输入输出、执行环境等多方面给出了详尽的讲解。如果你想加入 python的世界，David M beazley的这本书可不要错过哦。 (封面是最新英文版的,中文版貌似只译到第二版)

1

查看详情

• ^1.2.3 表示允许 ≥1.2.3 且 <2.0.0
• ^2.0.0 表示允许 ≥2.0.0 且 <3.0.0
• ^0.5.0 比较特殊：由于主版本为 0，通常认为不稳定，因此只允许修订更新，即 ≥0.5.0 且 <0.6.0

2. 波浪符号 ~：保守的增量更新

~ 提供更严格的版本限制，通常用于只允许修订版本（Patch）或特定范围的次版本更新。

它的规则是：锁定主版本和次版本，允许修订版本更新；但如果指定了两个版本段，则行为略有不同。

示例：

• ~1.2.3 表示允许 ≥1.2.3 且 <1.3.0 —— 即允许 1.2.x 的更新，不允许升级到 1.3.0
• ~1.2 等价于 ~1.2.0，表示允许 ≥1.2.0 且 <1.3.0
• ~2.0 表示 ≥2.0.0 且 <2.1.0

可以看出，~ 比 ^ 更保守，适合对依赖变化敏感的项目。

3. 星号 *：通配符，灵活但需谨慎

* 是一个通配符，常与其他版本格式结合使用，表示某个位置可以是任意值。

它通常出现在版本号的部分段落中，用来定义更宽泛的匹配规则。

示例：

• 1.* 表示允许所有 1.x 的版本，等价于 ≥1.0.0 且 <2.0.0
• 1.2.* 表示允许 1.2.x 的所有版本，即 ≥1.2.0 且 <1.3.0
• *.x 或 x.* 已过时，推荐使用 * 或明确版本

注意：* 单独使用（如 "vendor/package": "*"）表示接受该包的任何版本，风险较高，不推荐在生产环境中使用。

基本上就这些。掌握 ^、~ 和 * 的差异，能让你更精准地控制依赖版本，提升项目的稳定性和可维护性。合理使用这些符号，既能享受自动更新的便利，又能规避潜在的兼容性问题。

以上就是详解 composer 中的版本约束符号（^, ~, *）的详细内容，更多请关注php中文网其它相关文章！