Composer报“Could not find a version”主因是minimum-stability默认为stable，导致dev-main等非stable版本被直接跳过而非丢失；需用@dev等后缀显式指定或调整minimum-stability并更新锁文件。
为什么composer require报“Could not find a version”不是包丢了
因为 Composer 默认只认 stable 版本，而你要装的其实是 dev-main、v3.0.0-beta.1 或 2.x-dev 这类带稳定性标签的版本。它压根没把它们放进候选列表，不是找不到，是直接跳过。
运行 composer show -a vendor/package 看真实版本列表，末尾括号里写的 (dev)、(beta) 就是它的实际稳定性标签。如果没看到你要的版本，要么包名拼错，要么那个版本根本没发布到 Packagist。
-
minimum-stability必须写在composer.json最外层（和require同级），写在config或extra里完全无效 -
prefer-stable: true不会帮你“绕过”过滤——它只在多个可选版本里挑stable的；如果唯一可用的是dev-main，而minimum-stability是stable，那它连候选资格都没有 - 分支别名（如
dev-main）不是版本号，写成"vendor/pkg": "main"或"dev"都无效，必须写全"dev-main"
composer require vendor/package:dev-main@dev 是最简解法
加 @dev 后缀能覆盖全局 minimum-stability，只影响当前这一条依赖，不波及其他包。它比改 composer.json 更快、更安全。
-
@dev必须紧贴版本号，不能有空格：dev-main@dev✅，dev-main @dev❌ - 执行后，Composer 会自动把带
@的写法存进composer.json的require字段，不用手动改 - 同理，要装 beta 版就用
@beta，RC 版用@rc，@stable是冗余的（默认行为） - 如果包只发布了
dev-main，但你想让它“假装”是2.0.0以满足其他依赖的版本约束，可以写"dev-main as 2.0.0"
改了 minimum-stability 还报错？锁文件没更新
哪怕你手动把 composer.json 里的 minimum-stability 改成了 dev，只要 composer.lock 里还锁着旧解析结果，Composer 就不会重新评估依赖图——它直接按锁文件装。
- 必须运行
composer update --lock或composer update vendor/package触发重解析 - 项目已有大量依赖时，
composer update风险大，建议先加--dry-run看影响范围 - 某些私有仓库（如 Satis）没正确配置
dist信息时，dev-main可能被跳过——加-v参数跑composer require，看输出里有没有Skipped branch dev-main
真正容易被忽略的是：稳定性标签 ≠ 质量担保
dev-main 可能含未测功能，beta 版本 API 可能变动。确认你需要的 commit 或特性确实存在于那个分支/版本里，而不是只看名字匹配就往下冲。
运行 composer prohibits vendor/package:version 查具体哪个已有依赖在拦路，比盲目降级 minimum-stability 更准。稳定性设置只是开关，真正卡住你的，往往是 PHP 版本、扩展缺失或上下游依赖冲突。
