安装Composer包时遇到minimum-stability匹配问题求助

核心原因：你的包没有发布Composer认可的稳定版本 #

Composer判断一个包是否属于stable范畴，不是看minimum-stability配置，而是看包是否有符合语义化规范的正式版本标签：

• 必须是不带dev、alpha、beta、rc后缀的版本号，比如v1.0.0、2.2.0这类；
• 如果你的包只有代码分支（比如main/master），没有打正式标签，Composer会把分支版本识别为dev-main，属于开发版本，不符合stable要求，自然报错。

解决步骤 #

• 给你的包仓库打一个正式稳定版本标签：

  git tag v1.0.0
  git push origin v1.0.0
  

• 若包托管在Packagist，等待平台同步标签信息；若为私有仓库，确保Composer能访问到该标签；
• 回到项目重新执行composer require --dev my/package。

其他排查方向 #

• 检查包的composer.json，如果手动设置了version字段为dev-xxx，即使打了标签也会被判定为开发版本，建议删除该字段，让Composer自动从标签识别版本；
• 检查包的require字段，若依赖了其他不稳定版本的包，即使自身是稳定版本，也可能被Composer判定为不符合stable要求，需确保所有依赖都是稳定版本。

内容的提问来源于stack exchange，提问作者Jack33