应先用composer update --dry-run -v定位冲突包，再用composer why-not精准查出阻止安装的具体依赖关系，最后通过调整版本约束、利用branch-alias或排除冲突包来解决。
Composer 报错 “your requirements could not be resolved” 怎么办
这通常不是你写错了 composer.json，而是依赖树里两个包各自锁定了互斥的同一包版本（比如 A 要 monolog/monolog:^2.0，B 要 monolog/monolog:^3.0），而 Composer 默认不妥协——它拒绝降级、升级或跳过校验。直接删 vendor 或改 composer.lock 不解决问题，反而可能让下次 install 失败。
用 branch-alias 让旧版包“假装”是新版
某些包（尤其是 Symfony、Laravel 生态里的）在开发分支（如 main 或 dev-master）中通过 branch-alias 声明了语义化别名，例如把 dev-main 映射成 3.0.x-dev。当你 require 一个尚未发正式版但已有兼容实现的分支时，这个别名能让 Composer 认为它满足 ^3.0 的约束。
- 只对 已明确声明
branch-alias的包有效（查其composer.json的"extra": {"branch-alias": {...}}） - 别自己瞎加
branch-alias到自己项目里——它只在被依赖方的包定义中起作用 - 运行
composer show vendor/package可看到是否启用了别名及映射关系 - 若对方没设 alias，require
dev-main仍会被视为9999999-dev，无法匹配^3.0
临时绕过冲突：用 require --with-all-dependencies 或 conflict 排除
当 alias 不适用，又必须推进安装时，可考虑更务实的干预手段：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer require vendor/package:dev-main --with-all-dependencies强制将整个依赖树向该分支对齐（适合你控制主要包，且确认该分支实际兼容） - 在
composer.json的"conflict"字段中排除掉引发冲突的特定版本（例如"conflict": {"bad/package": "1.2.3"}），让 Composer 主动跳过它 - 慎用
composer update --ignore-platform-reqs—— 它绕过的是 PHP 扩展或版本限制，不是包间版本冲突 - 运行
composer why-not vendor/package:version能快速定位哪个上游包在阻止安装
为什么 minimum-stability 设成 dev 往往没用
很多人以为把 "minimum-stability": "dev" 加进 composer.json 就能自动选开发版来解冲突，其实不然：
- 它只影响 未显式指定稳定性后缀 的包（如写
"vendor/pkg": "^2.0"会考虑2.0.x-dev），但如果你的依赖链里已有明确要求^3.0，Composer 仍不会降级去拉2.x-dev - 它不改变版本比较逻辑，也不触发别名解析，只是放宽“默认允许哪些稳定性”
- 盲目调低 stability 容易引入不稳定代码，尤其在 CI 环境中可能导致偶发失败
真正关键的，是看清谁在锁死版本、谁提供了兼容实现、以及那个实现是否通过 branch-alias 正确暴露了语义化标签——这些信息都在 composer show 和依赖包的 composer.json 里，而不是在你的配置文件里藏着开关。
