--prefer-stable 仅对 composer update 生效，用于在满足约束的候选版本中优先选择稳定版，不改变版本范围，也不影响 install（因其只读 composer.lock）。
直接结论：用 --prefer-stable，但必须配合 composer update（不是 install），且它只在满足约束前提下“偏好”稳定版——不保证绝对装到 stable。
为什么 composer install 不受 --prefer-stable 影响
因为 install 只读 composer.lock，而 lock 文件里锁的是上次 update 时选中的版本。哪怕你加了 --prefer-stable，它也不会重新评估依赖树。
- 想让
--prefer-stable生效，必须运行composer update或composer update --prefer-stable - 如果 lock 文件里原本就锁着
"monolog/monolog": "dev-main"，那install就会照装，完全无视prefer-stable - CI 流水线中建议统一用
composer update --prefer-stable+ 提交更新后的composer.lock，避免环境漂移
--prefer-stable 和 minimum-stability 的关系
minimum-stability 是“准入门槛”，--prefer-stable 是“排序规则”——两者不冲突，但作用阶段不同。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"minimum-stability": "dev"允许装dev-main、beta、rc；没有它，--prefer-stable基本没意义 - 加了
--prefer-stable后，Composer 会在所有满足require约束的候选版本中，把stable排最前；但若唯一满足约束的只有dev-main，它还是会装 - 常见误判：以为开了
--prefer-stable就不会装@dev，其实只要composer.json里写了"monolog/monolog": "dev-main"，这个显式声明就直接覆盖所有偏好设置
私有仓库或 fork 导致 --prefer-stable 失效的原因
不是 prefer-stable 不起作用，而是你根本没让它参与决策——包来源被提前锁死了。
- 如果你的
repositories数组里把私有vcs仓库放在 packagist 镜像后面，Composer 会优先从镜像拉官方monolog/monolog:3.5.0（stable），但若镜像没同步该版本（比如国内镜像通常不抓dev分支，也常滞后 stable tag），它可能 fallback 到你私仓的dev-main - 更隐蔽的情况：私仓
type: vcs的 URL 写成https://git.example.com/my/monolog.git，某些 Composer 版本会忽略它，转而走 packagist，结果装到意外的不稳定版 - 验证方式：运行
composer show monolog/monolog，看输出里的source字段指向哪个 URL；再查composer why monolog/monolog，确认是哪个依赖把它带进来的
如何真正强制只用稳定版（绕过 --prefer-stable 的局限）
当项目对稳定性要求极高，且无法控制上游依赖的 minimum-stability 时，就得换策略。
- 删掉
composer.lock和vendor/，改composer.json中的require条目为精确版本，例如："monolog/monolog": "3.5.0"，再运行composer update monolog/monolog - 用
composer require monolog/monolog:3.5.0 --update-with-dependencies，它会重算整个子树并锁定 - 警惕
replace或platform配置——它们能骗过依赖检查，但不解决实际版本兼容性问题，调试时容易漏掉真实报错
真正麻烦的从来不是怎么写命令，而是搞清哪一层在决定版本：是你的 require？上游包的 composer.json？还是 repositories 顺序？先定位源头，再选工具。
