“branch conflict”或“dev-main not allowed”本质是minimum-stability策略拒绝不稳定版本，非网络或缓存问题；应先用composer show验证分支是否存在，再通过--stability=dev临时测试或在require中显式指定dev分支并配prefer-stable:true精准放宽。
看到“branch conflict”或“dev-main not allowed”先别删vendor
Composer 报分支冲突（比如 dev-main、dev-develop、1.x-dev）不是因为网络卡或缓存脏，而是当前 minimum-stability 或 prefer-stable 设置拒绝加载不稳定版本。盲目删 vendor/ 或 composer.lock 不但无效，还会丢失已验证的依赖快照。
常见现象包括：
- 执行
composer require vendor/package:dev-main后报Could not find a version of vendor/package matching dev-main -
composer install失败，提示Root package requires vendor/package dev-develop, but that version is not installable - 报错里出现
minimum-stability is stable或no matching package found
核心原因只有两个：该分支在 Packagist 上未标记为可发现（如没打 tag、没启用 auto-discovery），或你本地配置不允许加载 dev- 类版本。
确认分支是否存在且可见
别猜，直接查 Packagist 数据源。运行：
composer show vendor/package
看输出里有没有 dev-main、dev-develop 这类行；如果没有，说明这个分支根本没被 Packagist 索引到——可能作者还没 push 到 GitHub，或仓库没连上 Packagist 自动同步。
如果确定分支存在，但 composer show 不显示，检查是否被 minimum-stability 挡住：
- 运行
composer config minimum-stability，若返回stable，则默认不接受任何dev-分支 - 运行
composer config prefer-stable，若为true，Composer 会优先选 stable 版本，跳过dev-即使它满足约束
临时验证：加 --stability=dev 参数再试，例如：
composer require vendor/package:dev-main --stability=dev
成功即证明是稳定性策略问题，不是分支不存在。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
修改 composer.json 的稳定性策略要精准
改 composer.json 不等于全项目放开 dev 版本。推荐只对目标包放宽，而非全局降级：
- 错误做法：
"minimum-stability": "dev"—— 这会让所有依赖都倾向拉dev-分支，极易引发其他冲突 - 正确做法：在
require或require-dev中显式指定分支，并配"prefer-stable": true全局兜底 - 更安全写法：用
repositories手动指向 Git 仓库（适合私有或未发布分支）
示例（只允许某一个包走 dev 分支）：
{
"require": {
"vendor/package": "dev-main as 999.999.999"
},
"prefer-stable": true
}
注意 as 999.999.999 是语义化占位，避免 Composer 因版本号太“高”而拒绝安装；之后必须跑：
composer update vendor/package --with-dependencies
不加 --with-dependencies，它的子依赖仍按旧规则锁死，很可能导致运行时报 Class not found。
分支冲突常和 require-dev 隐形绑定有关
很多“分支装不上”的真实源头不在 require，而在 require-dev 里的工具链。比如：
-
phpunit/phpunit依赖sebastian/exporter，而后者某个dev-main分支要求 PHP 8.3，你环境是 8.2 → 直接封杀整条链 -
laravel/pint某个dev-develop版本强制要求symfony/console:^7.0，但你项目还在用 Laravel 9（绑symfony/console:^6.0）→ 冲突不报在 pint，而报在根依赖
排查方式：
- 先清掉
require-dev临时注释掉一半，再composer update --dry-run看是否通过 - 用
composer why-not vendor/package:dev-main，若输出为空，大概率是require-dev在暗中施压 - 运行
composer show --tree | grep -A3 -B3 "dev-"快速扫出哪些包实际拉了不稳定分支
真正难解的分支冲突，往往卡在“两个 dev 分支互相要求对方升版”，这时手动编辑 composer.json 加 conflict 比硬扛更稳——比如明确声明 "conflict": {"vendor/package": "dev-main"}，等对方发正式版再放开。
