Composer默认拒绝安装dev版本，因minimum-stability默认为stable；需在composer.json中设"minimum-stability": "dev"并配合"prefer-stable": true，或对单包使用@dev后缀。
Composer安装dev版本被拒绝：稳定版策略拦截
默认情况下，composer require 拒绝安装 dev- 开头的分支别名（如 dev-main、dev-develop），哪怕包仓库里只有开发分支——因为 Composer 默认只信任 stable 级别版本。这不是网络或权限问题，是版本稳定性策略在起作用。
常见错误现象：Could not find package vendor/name with stability dev 或 Your requirements could not be resolved to an installable set of packages，尤其在拉取 GitHub 上尚未打 tag 的新库时高频出现。
- 检查目标包是否真有
dev-分支可用：用composer show vendor/name --all查看所有可识别的版本 - 确认你本地
composer.json中未显式锁定"minimum-stability": "stable"（这是默认值，等效于没写） - 不要试图用
composer require vendor/name:dev-main直接硬装——没配允许策略前，这条命令必然失败
允许dev版本的两种生效配置方式
必须显式放宽最低稳定性约束，且需注意作用范围：全局配置影响所有项目，项目级配置只对当前 composer.json 有效，推荐后者。
项目级配置（推荐）：在项目根目录的 composer.json 中添加或修改字段：
{
"minimum-stability": "dev",
"prefer-stable": true
}
"prefer-stable": true 很关键——它让 Composer 在满足依赖的前提下，优先选 stable 版本；仅当 stable 不可用时，才退回到 dev 版本。这样既放开限制，又不破坏生产环境的稳定性偏好。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"minimum-stability": "dev"是开关，没有它，dev-分支永远不可见 - 若只写
"minimum-stability": "dev"而不加"prefer-stable": true，所有包都会倾向装 dev 版，风险陡增 - 改完记得运行
composer update --lock刷新锁文件，否则旧 lock 可能继续阻断安装
按包单独放开稳定性限制（精准控制）
不想全局或整个项目都接受 dev 版？可以用 require 的 inline stability flag 实现包级豁免。语法是在包版本号后加 @dev：
composer require monolog/monolog:@dev
这等价于告诉 Composer：“只对这个包，允许降级到 dev 稳定性，其他包照旧遵守 minimum-stability 规则”。
- 支持完整分支名，如
composer require vendor/name:dev-feature/x@dev - 该写法会自动更新
composer.json的require字段，并把对应条目写成"vendor/name": "dev-feature/x as 1.0.0"形式（如果带 as 别名） - 注意：如果项目已设
"minimum-stability": "stable"，单靠@dev不足以绕过——必须至少设为"dev"或"RC"等更低级别，@dev才能生效
为什么 composer create-project 有时能装 dev 却不报错？
因为 create-project 默认忽略项目自身的 minimum-stability 设置，直接按命令行指定的版本安装。例如：
composer create-project laravel/laravel myapp dev-develop
这条命令成功，不代表你的项目后续 composer require 也能装 dev- 包——它只是“创建时放行”，不改变项目配置。很多用户误以为这样就一劳永逸，结果第二天 require 新包时报错，就是这个原因。
- 验证方法：进新项目目录，执行
composer require phpunit/phpunit:@dev，大概率失败，除非你已手动配置minimum-stability - 真正要长期用 dev 版，必须落实到
composer.json配置，而不是依赖某次命令的临时行为 - CI/CD 流水线中若用
create-project拉 dev 分支，务必同步注入正确的稳定性配置，否则后续依赖安装阶段会中断
