composer why-not 直接模拟安装失败定位首个不兼容包，需指定完整包名+版本号；composer depends -r 查找强制约束的上游组件；composer show --tree 展开依赖树验证版本选择逻辑。
composer why-not 会直接告诉你冲突根源
它不是猜，是让 Composer 模拟安装失败时的依赖图，定位到第一个不兼容的包。比如你想装 monolog/monolog:^2.0，但项目里已有 laravel/framework:v8.0，后者锁死了 monolog/monolog:^1.0，composer why-not monolog/monolog:2.0 就会输出哪条路径卡住了升级。
- 必须指定完整包名+版本号（如
vendor/package:1.2.3或vendor/package:^2.0），不能只写monolog - 运行前确保
composer.json已更新目标版本，否则它分析的是当前已满足的状态 - 如果报错
[InvalidArgumentException] Package not found，说明该包没在composer.json或 lock 文件里注册过——它只能分析“已被声明但无法满足”的依赖
composer depends -r 查看谁在拖后腿
当你发现某个包被锁在旧版，想快速知道是哪个上游组件强制要求它，composer depends -r vendor/package 就是答案。比如 composer depends -r symfony/console 会列出所有直接或间接依赖它的包，并标出各自声明的约束范围。
-
-r是关键参数，代表递归查找（包括 transitive dependencies）；不加的话只显示直接 require 的包 - 输出里带
requires的行才是真正的约束来源；带replaces或provides的不用管 - 注意看版本约束符号：
^4.4和~4.4.0看似一样，但实际允许的版本范围有细微差别，可能就是冲突点
composer show --tree 揭露隐藏的间接依赖链
有些冲突不是来自你写的 require，而是某依赖的依赖悄悄引入了不兼容版本。用 composer show --tree vendor/package 能展开整条依赖树，比 depends 更细粒度地看到每个节点的版本选择逻辑。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 它不会自动高亮冲突，但能帮你验证：为什么明明写了
^3.0，最终却装了2.9.9？顺着树往上翻，大概率在第二层或第三层某个包写了"vendor/package": "2.*" - 输出中如果某行末尾带
(locked to X.Y.Z)，说明这个版本已在composer.lock固定，删 lock 文件再composer update才可能松动 - 树太深时建议配合
grep：例如composer show --tree monolog/monolog | grep -A5 -B5 "symfony/.*console"
冲突常发生在 require-dev 和平台配置上
很多人只盯着 require，忘了 require-dev 里的包也可能拉入冲突依赖，尤其是测试工具链（如 phpunit/phpunit）对 PHP 版本、ext-json 等有强约束。另外 config.platform 伪造的环境信息也会误导 Composer 的版本决策。
- 运行
composer why-not前先确认是否启用了--no-dev；默认它是包含 dev 包的，而生产部署可能禁用它们 - 检查
composer.json里有没有"config": {"platform": {"php": "7.4.0"}}这类设置——它会让 Composer 忽略真实 PHP 版本，强行选低版本包 - 某些包（如
nette/utils）在不同 PHP 版本下会提供不同接口，但 Composer 不校验运行时兼容性，只看php的require字段，这点容易漏判
真正难解的冲突，往往藏在三层以上的依赖里，且和 require-dev 或平台配置耦合。手动删 lock、开 verbose 日志（composer update -v）、逐个排除 dev 包，比靠直觉猜快得多。
