Composer报“no matching package found”通常因包无稳定版或稳定性约束不匹配；需在根composer.json顶层设minimum-stability（如"beta"），配合"prefer-stable":true，并运行composer update；更安全的是用@后缀按需覆盖单个包稳定性。
直接改 minimum-stability 不解决根本问题，多数情况是包本身没发布稳定版，或你锁定了不兼容的稳定性约束。
为什么提示 “no matching package found” 且提到 stability？
Composer 默认只允许安装 stable 版本（即无 -dev、-alpha、-beta、-rc 后缀的版本）。当你 require 一个尚未发布稳定版的包（比如只发布了 v1.0.0-beta.2），或该包的 composer.json 中声明了 "minimum-stability": "dev" 但你的项目没同步放宽，就会报这个错。
- 错误典型信息：
Could not find a version of package vendor/name matching your minimum-stability (stable) - 不是所有包都必须有 stable 版；很多活跃开源库长期停留在
beta或rc -
minimum-stability是项目级默认值，可被每个require条目用@后缀覆盖
改 minimum-stability 的正确姿势
在项目根目录 composer.json 的顶层（与 require 同级）设置，**不要写在 require 里或子对象中**：
{
"minimum-stability": "beta",
"prefer-stable": true,
"require": {
"monolog/monolog": "^2.0"
}
}
- 常用值：
stable（默认）、RC、beta、alpha、dev—— 注意大小写敏感，RC必须全大写 -
"prefer-stable": true很关键：它让 Composer 在满足minimum-stability前提下，优先选 stable 版（例如有1.2.0和1.3.0-beta.1，仍装1.2.0） - 改完必须运行
composer update（不是install），否则不生效
更安全的做法：按需覆盖单个包的稳定性
不降低整个项目的稳定性水位，只为特定包临时放宽：
{
"require": {
"laravel/sanctum": "^3.0.0@beta",
"spatie/laravel-backup": "^8.0.0@rc",
"myvendor/mylib": "dev-main"
}
}
- 后缀直接写在版本号后面，用
@连接，如"^2.1@alpha" -
dev-main表示装 main 分支最新提交（等价于"dev-main as 2.0.x-dev"） - 这种写法优先级高于
minimum-stability，且不影响其他包 - 适合测试新功能、依赖未发版的 PR、或内部私有包
检查包真实可用版本和稳定性标签
别猜，用命令确认：
-
composer show vendor/package --all：列出所有带 stability 标签的版本 -
composer depends --tree vendor/package：看谁依赖了它，是否因传递依赖被卡住 - 访问 Packagist 页面，看 “Versions” 栏明确标出每个 tag 的 stability 级别
- 注意：有些包把
dev-master设为默认分支，但没打任何stabletag，此时必须显式指定@dev或改minimum-stability
真正麻烦的不是配置项本身，而是团队协作时有人忘了删掉本地临时加的 @dev，结果上线构建失败——建议把稳定性要求写进 CI 脚本的 composer install --no-dev 前置检查里。
