prefer-stable 是 composer 的版本偏好配置,启用后在满足 minimum-stability 前提下优先选择更稳定的版本;需配合 minimum-stability 使用,单独设置不阻止显式声明的 dev 版本。
prefer-stable 是 Composer 用来控制包版本选择倾向的关键配置项——它不会强制安装稳定版,但会让 Composer 在满足依赖约束的前提下,优先选择 stable(即 stable、RC、beta 等标记为稳定级别的版本),而不是默认可能拉取 dev-master 或带 -dev 后缀的开发快照。
如何全局或项目级启用 prefer-stable
该配置支持两种设置方式,行为略有差异:
- 项目级:写入当前项目的
composer.json的config段,仅影响本项目 - 全局级:执行
composer config -g prefer-stable true,影响所有后续项目(除非被项目级覆盖)
推荐优先用项目级配置,避免意外污染其他项目。示例写法:
{
"config": {
"prefer-stable": true
}
}
注意:"prefer-stable": true 必须配合 "minimum-stability": "stable" 才能真正限制只装稳定版;单独设 prefer-stable 时,若依赖明确要求 "dev-main" 或 "@dev",Composer 仍会照装。
minimum-stability 和 prefer-stable 的关系
这两个配置常被混淆,但作用完全不同:
-
minimum-stability是“准入门槛”:定义允许安装的最低稳定性级别(如设为stable,则beta及以下默认不被接受) -
prefer-stable是“选版本时的偏好”:在多个满足minimum-stability的候选版本中,优先挑更稳定的那个
典型组合是: