composer require vendor/package:2.5.0-beta1 --stability=beta 是正确方式，因 @beta 无效；必须显式指定完整 beta 版本号并配合 --stability=beta 参数，否则 Composer 会优先安装满足语义版本约束的 stable 版本。
composer require 时怎么加稳定性标记
直接在版本号后加 @dev、@beta、@RC 或 @stable 是无效的，composer require vendor/package@beta 会报 Could not find a matching version。真正起作用的是 --stability 参数或项目级 minimum-stability 配置。
临时给单个包降级稳定性，用这个命令：
composer require vendor/package:2.5.0-beta1 --stability=beta
要点：
-
--stability必须小写，值只能是dev、alpha、beta、RC、stable（注意RC全大写） - 版本号必须严格匹配包已发布的 tag，比如
2.5.0-beta1，不能写成2.5@beta或^2.5@beta - 如果版本不存在，
composer show -a vendor/package比盲试快得多，它会列出所有带稳定性标识的真实 tag - 加引号更安全：
composer require "laravel/framework":"9.0.0-RC1" --stability=RC，防 shell 把破折号当参数分隔
为什么写了 @beta 还装不上 stable 版本
不是语法错，而是 Composer 的“语义版本优先”逻辑在起作用：当你只写 composer require vendor/package:^2.0@beta，它其实会忽略 @beta，转而按 ^2.0 解析——而 stable 版本（如 2.9.5）完全满足该约束，且比 2.10.0-beta1 更稳定，所以默认就选了前者。
想强制走 beta，必须同时满足两个条件：
- 显式指定完整 beta 版本号，如
2.10.0-beta1 - 带上
--stability=beta，告诉 Composer “允许把 beta 当作合法候选”
否则，哪怕 minimum-stability 设为 beta，只要你在 require 里写的是 ^2.0，Composer 仍可能选 2.9.5（stable）而非 2.10.0-beta1 —— 因为它更符合语义版本升序规则。
prefer-stable 和 --stability=xxx 能一起用吗
能，而且这是最稳妥的组合：它让 Composer 在你允许的稳定性范围内（由 --stability 定义），优先挑最稳定的那个版本。
例如：
composer require monolog/monolog:3.0.0-beta1 --stability=beta --prefer-stable
效果是：只考虑 beta 及以上版本，但如果有 3.0.0（stable）和 3.0.0-beta1 同时存在，就选 3.0.0；如果只有 3.0.0-beta1，那就装它。
对比单独用 --stability=beta：
- 后者可能装
3.1.0-beta2（更新但不稳定） - 加了
--prefer-stable就会卡在3.0.0-beta1（同 beta 级别里最靠前的）
注意：--prefer-stable 是排序策略，不是开关；它不阻止安装 beta，只是让 stable 在同级中胜出。
装完发现 vendor 里还是 dev 分支
大概率是版本号被误解析为分支名。比如你运行了 composer require vendor/package:2.1.0，但包没发布过 2.1.0 tag，Composer 就会 fallback 到 dev-2.1.0 分支（如果存在），结果 vendor/ 里全是最新 commit，composer.lock 中 source.reference 是长哈希而非空或短 hash。
验证方式：
- 打开
composer.lock，找到该包条目，检查version字段是否为"2.1.0"，且source.type是"dist" - 若
source.reference是 40 位 commit hash，说明拉的是 source，不是 dist 包
临时解法：删掉 vendor/ 和 composer.lock，重跑 composer install；根治法是确保版本号真实存在，或改用带引号的精确写法 "2.1.0"，避免 shell 或 Composer 解析歧义。
