composer show -a 能直接暴露包的稳定性状态,它读取 Packagist 元数据,按时间倒序列出版本,带 -dev 后缀或无数字前缀(如 dev-main)即为不稳定版,1.5.0 后紧接 2.0.0-beta.3 和 2.x-dev 表明主干已进入预发布阶段但未标记 stable。

composer show -a 能直接暴露包的稳定性状态
Composer 本身不提供“自动检测稳定性”的独立命令,但 composer show -a 是最贴近真实场景的稳定性快照工具。它读取 Packagist 上已发布的元数据,而非本地 composer.json 的主观声明,因此能一眼识别出哪些版本是 stable、哪些只是 dev-main 或 2.x-dev 分支。
- 运行
composer show -a vendor/package后,输出中 “versions” 列表会按时间倒序排列,带-dev后缀或无数字前缀(如dev-main)的都属于不稳定版本 - 若最新版是
1.5.0,但下面紧跟着2.0.0-beta.3和2.x-dev,说明主干已进入预发布阶段,但尚未标记为 stable -
type字段值为library通常表示通用稳定包;而symfony-bundle或laravel-package这类框架绑定型包,其稳定性还依赖于对应框架版本是否兼容
minimum-stability 配置决定实际安装行为
即使远程有 stable 版本,项目里 minimum-stability 设太低也会拉下不稳定分支。这个字段不是“检测用”,而是“执行开关”——它控制 Composer 解析版本约束时的默认过滤阈值。
- 默认值是
stable,此时composer require vendor/pkg只会选1.2.3这类语义化稳定版,跳过所有-dev、-beta、-rc - 设成
dev后,composer update可能悄悄把dev-main写进composer.lock,尤其当远程没有满足^2.0的 stable 版时 - 该配置可全局设置(
composer config -g minimum-stability dev),也可在项目级composer.json中覆盖,但 CI 环境强烈建议显式锁定为stable,避免因开发机配置污染构建结果
为什么 composer why 不显示 stability 信息但很关键
composer why 本身不输出稳定性标签,但它能帮你定位“谁在偷偷降级稳定性”。很多项目最终装上 dev-main,不是因为主项目写了 "dev-main",而是某个间接依赖(比如测试工具链)强制要求了不稳定版本。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 执行
composer why vendor/package,如果返回的是phpunit/phpunit→sebastian/exporter→ 你的包,就要去查sebastian/exporter的composer.json:它是否在require-dev里锁死了"phpunit/phpunit": "dev-main"? - 这种传递性 destabilization 很难靠肉眼发现,
composer depends --tree vendor/package可以展开整条依赖树,找到那个没加 stability 限制的中间包 - 修复方式不是删掉它,而是给该包加
"@stable"后缀约束,例如:"sebastian/exporter": "^5.0.0@stable",强制 Composer 忽略其 dev 分支
检查 packagist.org 页面比看文档更可靠
Packagist 页面右上角的 Last update 和下方的 Releases 标签页,是判断分发稳定性的第一手信号。它不依赖作者是否写了 stability 字段,而是反映真实发布动作。
- 点开
Releases,只看到v1.0.0-RC1和一堆dev-提交哈希?说明作者还没走完正式发布流程,哪怕composer.json里写了"version": "1.0.0"也没用 - 页面底部 “Source” 链接指向 GitHub,进去看
composer.json的type和autoload:如果autoload是空的或只含files,那这个包大概率没经过 PSR-4 自动加载验证,连基本集成稳定性都存疑 - 别信 README 里的 “Production Ready”,直接搜 issues 里有没有 open 状态的
critical或security标签——6 个月内有未修复的 critical issue,就别把它放进require,哪怕它版本号是3.0.0
真正容易被忽略的是:Composer 对稳定性的判定基于 tag 名称和 Git 分支策略,而不是代码质量。一个 v2.0.0 tag 如果没打在 main 分支上,或者没通过 Packagist 的 webhook 同步,composer show -a 就不会列出它——你得手动确认仓库是否已正确连接并触发索引。










