详解Composer依赖解析中的prefer-stable配置-composer-PHP中文网

prefer-stable 是排序偏好而非开关，仅在多个满足约束的版本中优先选 stable 版；它必须置于 composer.json 根级，配合 minimum-stability 才生效，不改变可安装版本范围，也不禁止非稳定版。

详解composer依赖解析中的prefer-stable配置

prefer-stable 是什么，不是什么

prefer-stable 是一个布尔型配置项，作用是在满足所有依赖约束的前提下，让 Composer 优先选择更稳定的版本（如 2.5.0 而非 2.5.0-beta1 或 dev-main），但它不会拒绝不稳定版本——只要没有更稳定的可选项，它仍会装 dev 或 beta。

它不是强制降级开关，也不是稳定性门槛。门槛由 minimum-stability 控制；prefer-stable 只是排序偏好，类似“在合格候选人里优先挑资历深的”，不改变“合格”的定义。

常见误判：

写了 "prefer-stable": true 却发现装了 dev-main → 很可能某个 require 条目显式写了 "some/pkg": "dev-main"，直接绕过偏好
执行 composer install 后仍是 dev 版本 → composer.lock 已锁死旧版本，install 不重新解析，得用 composer update --prefer-stable 或删 lock 后重来

怎么正确启用 prefer-stable

必须写在 composer.json 的**根层级**，不能塞进 config 字段里：

{
  "prefer-stable": true,
  "minimum-stability": "dev",
  "require": {
    "symfony/console": "^6.4"
  }
}

"config": { "prefer-stable": true } 是无效写法，Composer 完全忽略。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

命令行临时启用也有效，但只影响当次命令：

composer update --prefer-stable：适合 CI 流水线加固，避免某天突然拉到 rc 版本导致测试失败
composer require monolog/monolog --prefer-stable：加新包时立即生效
composer config -g prefer-stable true：全局配置无效，Composer 不支持

为什么开了 prefer-stable 还装了 dev 包

三个最常被忽略的原因：

你的 require 或某个依赖的 composer.json 显式声明了 "pkg": "dev-main" 或 "@dev" —— stability flag 优先级最高，直接覆盖 prefer-stable
上游包自身设了 "minimum-stability": "dev"，又没配 "prefer-stable": true，它的子依赖就可能把 dev 带进来
你只运行了 composer install，而 composer.lock 里原本就锁着一个 dev 版本 —— 想让它重新评估，得加 --with-dependencies 或删 lock 后再 update

prefer-stable 和 minimum-stability 怎么搭配才不打架

两者是协作关系，不是互斥开关：

"minimum-stability": "stable" + "prefer-stable": true → 实际无差别，因为 stable 已是底线，没更稳可选
"minimum-stability": "dev" + "prefer-stable": true → 理想组合：允许开发分支存在（比如你本地要验证 laravel/framework:dev-feature-xxx），但其他包如 monolog/monolog、symfony/http-foundation 会尽量选 3.5.0 而非 4.0.x-dev
"minimum-stability": "beta" + "prefer-stable": true → 若某包有 2.0.0-beta3 和 2.0.0 两个候选，会选后者（仍 ≥ beta）

真正容易踩坑的是：只改了 minimum-stability 却忘了配 prefer-stable，结果项目一跑 update 就全变成 dev-main，连核心框架都飘在空中。