Composer报“找不到匹配版本”主因是版本约束与Packagist实际索引的发布物不匹配；需检查包名、源配置、稳定性设置，并用composer show -a确认真实可用版本，再选用对应稳定tag（如"2.5.0"）或加@stable后缀。
直接换用带@stable后缀的版本约束，或删掉dev-前缀改写为对应稳定标签（如v2.5.0），就能绕过分支不存在的问题。这不是 Composer “切版本”，而是你写的约束本身就不匹配远程真实存在的发布物。
为什么dev-main会报“package not found”
Composer 查分支不是实时连 Git 仓库拉代码，而是查 Packagist 元数据里有没有记录这个分支名。如果项目没配置 repositories、没启用 webhook、或者作者根本没在 Packagist 上注册该分支，dev-main 就等于不存在。
- 运行
composer show -a vendor/name，输出里没出现dev-main（只有v2.5.0、2.4.x-dev等），说明 Packagist 根本没索引它 - 私有 Git 仓库必须显式声明
"type": "vcs"和完整url，漏一个字段就静默忽略，继续查默认源 -
dev-main要求远程 Git 仓库存在main分支；如果作者已重命名为master或develop，这个约束就失效
怎么快速改成能装的稳定版
别改 minimum-stability，直接在 require 里加稳定性后缀，精准生效：
- 把
"vendor/name": "dev-main"改成"vendor/name": "dev-main@stable"—— 强制只取该分支下打了stable标签的 commit（极少用） - 更常用的是换成真实存在的 tag：
"vendor/name": "2.5.0"或"vendor/name": "^2.5" - 不确定最新稳定版号？先跑
composer show -a vendor/name，找末尾标着(stable)的那一行，抄下来直接用 - 如果只想要最新
stable但又怕踩坑，写"vendor/name": "^2.5@stable"，比单纯"^2.5"更明确
--stability=dev 不是万能解药
加这个参数只是放宽当前命令的稳定性限制，但它不能凭空变出一个分支。如果 Packagist 没收录 dev-main，或者你的 repositories 配置无效，它照样报错。
-
composer create-project vendor/name my-app "dev-main" --stability=dev失败 → 说明dev-main在源里确实不存在 - 此时不要反复试
--stability，立刻执行composer show -a vendor/name看真实可用项 - 若输出为空或只有
dev-xxx但没你想要的分支，基本可判定：包作者没发、镜像没同步、或你拼错了 vendor 名
最常被忽略的一点：很多项目把主开发分支叫 main，但 Packagist 只认它发布的 tag，不认分支快照。你看到 GitHub 上有 main 分支，不等于 Composer 就能直接装 dev-main——得作者手动 push tag 或配置自动同步。
