直接装 beta 版本最安全的方式是使用 --stability=beta 参数，而非修改 minimum-stability；后者会全局降低稳定性门槛，导致间接依赖也被升级到 beta 版，引发不可控风险。
一句话总结：直接安装 beta 版本，不改动全局配置是最安全的路径。而修改 minimum-stability 则属于高风险操作，很容易连带把其他依赖也升级到不稳定状态，局面就不好控制了。
为什么 composer require vendor/package:2.5.0-beta1 会失败
这事儿其实跟网络或者包存不存在关系不大。核心问题在于，Composer 在解析依赖时发现：项目当前的 minimum-stability 设置是 stable（默认值），而你要的 2.5.0-beta1 版本，其稳定性标签是 beta。这就好比门槛设得太高，直接把“不稳定”的版本给过滤掉了。
遇到这种情况，先别急着下结论，可以按下面几步排查：
- 运行
composer show -a vendor/package命令，确认这个 beta 版本确实存在，并且括号里标注的是(beta)。 - 仔细核对版本字符串是否严格匹配。比如，
2.5.0-beta1不能写成2.5.0.BETA1（大小写问题）、2.5.0-beta（缺少数字）或者2.5.0-beta1@dev（标记冲突）。 - 还有一个隐蔽的坑：如果这个包的
composer.json里，"version"字段写的是"dev-main"，那么即使 Git 仓库里有2.5.0-beta1这个标签，Composer 也可能无法识别它。
临时安装 beta 版的正确命令
想安全地尝鲜 beta 版，正确姿势是使用 --stability=beta 参数。这个参数只影响当前这条命令，不会污染项目的整体稳定性策略，可以说是“精准打击”：
composer require vendor/package:2.5.0-beta1 --stability=beta
或者，如果你想安装该系列（比如 2.5.*）中最新的 beta 版本，可以这么写：
composer require vendor/package:^2.5@beta
这么做有几个好处：
- 完全不需要提前手动修改
composer.json文件，也不用删除composer.lock。 - 命令执行成功后，
composer.lock文件会自动记录下这个包精确的 beta 版本号和对应的稳定性标签。 - 后续执行常规的
composer update时，它不会自动把这个包升级到下一个 beta 版本，除非你再次显式指定。这给了你足够的控制权。
改 minimum-stability 的实际影响
如果你选择在 composer.json 的根对象里直接加上 "minimum-stability": "beta"，那影响范围可就大了。这意味着所有没有显式锁定稳定版本的依赖约束都会“松动”：
- 比如，你写着
"monolog/monolog": "^3.0"，Composer 可能就会给你装上3.0.0-beta2，而不是稳定的3.0.1。 - 更棘手的是间接依赖（依赖的依赖）。比如包 A 依赖包 B，包 B 又依赖包 C。即使你从未主动 require 包 C，它也可能因为这条全局规则被带入 beta 版。
- 这时候，通常必须同步加上
"prefer-stable": true设置。否则，像^3.0这种版本约束，甚至有可能直接匹配到dev-main这样的开发分支。 - 修改完
minimum-stability后，记得运行composer update vendor/package --with-all-dependencies来重新计算整个依赖图。只运行install是不会触发重新解析的。
装完还是 stable？检查这三点
有时候命令明明返回成功了，但用 composer show vendor/package 一看，显示的却还是旧的 stable 版本。这说明你的安装请求根本没生效。问题可能出在以下几点：
- 首先，确认
composer.lock文件中该包的条目是否已经被更新。如果没更新，那说明依赖解析过程绕过了你的新要求。 - 其次，检查是否有其他已经安装的包依赖了该包更高的稳定版本。例如，另一个包
another/pkg要求vendor/package:^2.6，那么 Composer 就会拒绝降级安装到2.5.0-beta1。 - 最后，留意 CI（持续集成）或部署环境。它们可能使用了
--no-interaction参数并配合缓存的composer.lock文件，从而跳过了重新解析依赖的步骤。
话说回来，真正让人头疼的从来不是怎么写对一条命令，而是当项目里多个包对同一个依赖提出了不同稳定性要求时，Composer 内置的 SAT 解析器会如何取舍。这时候，就得祭出排查神器了：运行 composer why-not vendor/package:2.5.0-beta1，它能清晰地告诉你，具体是哪一层的依赖约束卡住了你的安装请求。这才是解决问题的关键所在。
