prefer-stable 必须置于 composer.json 根级，非 config 下；它仅在 minimum-stability 允许不稳定版本时影响排序，不解决冲突，不改变约束逻辑，且不支持全局配置。
prefer-stable 配置必须写在 composer.json 顶层，不能放在 config 下
很多人把 "prefer-stable": true 错误地塞进 "config" 块里，比如：
{
"config": {
"prefer-stable": true
}
}
这个写法完全无效——Composer 解析时直接忽略它。正确位置是和 require、minimum-stability 并列的根级字段：
{
"prefer-stable": true,
"minimum-stability": "dev",
"require": {
"laravel/framework": "^10.0"
}
}
-
prefer-stable是布尔开关，只影响版本选择排序，不改变约束逻辑 - 它只在
minimum-stability允许不稳定版本（如"dev"或"beta"）时才有实际作用 - 如果
minimum-stability已是"stable"，加prefer-stable等同于没写
开了 prefer-stable 还装了 dev-main？先查这三处
看到 vendor/ 里出现 dev-main，别急着改配置。高频原因就三个：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 你的
require或某个依赖的composer.json显式写了"some/pkg": "dev-main"或"@dev"—— stability flag 优先级高于prefer-stable - 上游包自己设了
"minimum-stability": "dev"，又没声明"prefer-stable": true，它的子依赖就可能把dev带进来 - 你只运行了
composer install，而composer.lock里原本就锁着一个dev版本；想让它重新评估，得加--with-dependencies或删掉composer.lock后再composer update
命令行用 --prefer-stable 和写配置项的区别
--prefer-stable 是临时开关，只对当次命令生效；"prefer-stable": true 是项目级默认行为，后续所有 composer install 和 composer update 都自动带上。
- CI 流水线推荐用
composer update --prefer-stable：不污染本地配置，每次构建都明确控制 - 团队开发中，建议把
"prefer-stable": true写进composer.json，避免成员各自加参数导致行为不一致 - 全局配置
composer config -g prefer-stable true无效——Composer 不支持全局prefer-stable
prefer-stable 不解决冲突，只影响版本排序
这是最容易误解的一点：prefer-stable 不会帮你绕过冲突，也不会让 Composer “接受”不兼容的版本组合。它只做一件事：在满足所有约束的前提下，从多个可选版本中优先挑 stable 的那个。
- 如果唯一能满足约束的是
monolog/monolog:3.0.0-RC1，那即使开了prefer-stable，也会装 RC 版 - 遇到
Conclusion: don't install laravel/framework v11.0.0这类报错，说明约束根本无法同时满足，此时该用composer why-not laravel/framework:11.0.0定位阻断链，而不是调prefer-stable - 真正起效的稳定策略是组合使用：
"minimum-stability": "stable"+ 精确版本锁定（如"nesbot/carbon": "2.85.0"），而非依赖偏好机制
复杂点在于：prefer-stable 的效果高度依赖 minimum-stability 的设定、上游包自身的稳定性声明、以及 lock 文件的历史状态——它不是独立生效的开关，而是整个依赖解析链条中一个微调参数。
