^允许主版本不变的兼容更新，如^1.2.3支持1.2.3到2.0.0之间版本；~更严格，通常只允许修订更新，如~1.2.3限于1.2.3到1.3.0之间，适用于需稳定依赖的场景。

在 composer.json 文件中，你经常会看到类似 "^1.2.3" 或 "~1.2.3" 这样的版本约束。这些符号是 composer 用来定义依赖包版本范围的规则，理解它们有助于更好地控制项目依赖的更新行为。

^ 版本约束：兼容性更新

^ 符号表示“允许向后兼容的更新”。它遵循语义化版本（SemVer）规则，允许在不破坏兼容性的前提下进行更新。

例如：

• ^1.2.3 表示允许安装 1.2.3 到 2.0.0 之间的版本（不包含 2.0.0）
• ^2.0.0 表示允许从 2.0.0 到 3.0.0 之前的版本
• ^0.3.4 比较特殊，因为 0.x 版本被视为不稳定，所以只允许更新到 0.4.0 之前，即允许 0.3.4 到 0.4.0 之间的补丁和次版本

简单来说，^ 会锁定主版本号不变，允许次版本和修订版本升级。

~ 版本约束：仅限修订更新

~ 符号更严格一些，它表示“允许修订版本（patch）更新，有时也包括次版本”，具体取决于你指定的版本粒度。

阿里妈妈·创意中心

阿里妈妈营销创意中心

0

查看详情

例如：

• ~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 之前的版本
• ~1.2.3 不会允许升级到 1.4.0 或 2.0.0

也就是说，~ 通常锁定主版本和次版本，只允许修订版本更新，但在省略 patch 号时会放宽限制。

实际使用建议

根据项目稳定性需求选择合适的版本约束：

• 如果你希望自动获取安全更新和小功能改进，使用 ^ 是合理的选择，尤其适用于成熟的库（如主版本 ≥1）
• 如果你对依赖变更非常敏感，比如生产环境或关键系统，可以使用 ~ 来限制更新范围，减少意外风险
• 对于开发阶段的包（版本为 0.x），注意 ^0.3.4 和 ~0.3.4 行为可能不同，需特别留意

基本上就这些。掌握 ^ 和 ~ 的区别，能让你更精准地控制依赖版本，避免不必要的升级冲突或安全隐患。