Composer 的 stability-flags 和 prefer-stable 配置有何关联和区别？

stability-flags 是包级显式标记，优先级最高，覆盖全局设置；prefer-stable 是全局安装偏好，仅影响版本选择逻辑，需配合 minimum-stability 生效；二者分别实现“点上突破”与“面上引导”，共同构成完整稳定性策略。

stability-flags 和 prefer-stable 都是 Composer 控制依赖稳定性行为的机制，但作用层级、生效方式和使用场景完全不同。

stability-flags 是包级的显式标记

它写在 require 或 require-dev 的具体包版本后面，只影响那个包本身。常见形式有：

• "monolog/monolog": "2.9.0@beta" —— 强制安装 2.9.0 的 beta 版本
• "vendor/pkg": "@dev" —— 允许安装任意 dev 分支（如 dev-main）
• "vendor/pkg": "dev-main as 1.2.3" —— 把 dev-main 当作 1.2.3 来解析，满足其他包的版本约束

这种写法优先级最高，会覆盖 minimum-stability 和 prefer-stable 的全局设置。适合个别包必须用开发版、又不想放宽整个项目稳定性的场景。

prefer-stable 是全局的安装偏好

它不改变可安装的范围，只影响“选哪个版本”的决策逻辑。启用后（"prefer-stable": true），Composer 在满足所有约束的前提下，会优先选择更稳定的版本。

标签： composer ai 区别