composer why-not 默认只显示阻止安装的最短依赖路径，而非全部冲突源；要查看所有阻碍点需配合 composer prohibits 命令。
composer why-not 为什么只显示一条路径
它默认只输出“阻止安装”的最短依赖路径，不是全部冲突源。比如你执行 composer why-not laravel/framework:10.0，返回的可能是 package-a v2.1 → symfony/console ^5.4 这一条链，但实际还有 package-b v3.0 → symfony/console ^6.0 同时在拦路——why-not 不会主动并列展示。
真正要看到所有阻碍点，得配合 composer prohibits：
- composer prohibits laravel/framework:10.0 会直接列出所有明确声明不兼容该版本的包（含 conflict 字段）
- 如果输出为空，说明没硬性冲突，问题出在间接依赖的版本拉扯上
why-not 输出里出现 dev-main 或 * 怎么办
这代表某个依赖用了不稳定约束，比如 "require": {"monolog/monolog": "dev-main"} 或 "*"。这类写法会让 Composer 尝试拉取最新提交，极易触发平台不兼容或子依赖循环。
- 运行
composer show monolog/monolog dev-main确认该分支是否真实存在、PHP 版本要求是否匹配 - 检查
composer.json里有没有漏掉"minimum-stability": "stable"，导致 dev 分支被意外纳入求解范围 - 把
dev-main改成具体 tag（如^3.0），再跑composer update monolog/monolog --dry-run -v看是否还卡住
why-not 报 “no matching package found” 是什么问题
不是依赖冲突，而是你输错了包名或版本格式。Composer 对大小写、斜杠、空格极其敏感。
先验证包是否存在：
- composer show laravel/framework（不带版本）看是否能查到基础信息
- composer show -a laravel/framework 查全量版本列表，确认 10.0 是否真在其中（注意：没有 10.0 只有 10.0.0 或 v10.0.0 都算“不存在”）
- 打开 https://www.php.cn/link/e4e2602e040333a9d03277cf9312e1a7，点 Versions 标签页，核对你要的版本是否发布、后缀是否一致（10.0.0-beta.2 ≠ 10.0.0）
为什么 why-not 没用，但项目就是装不上新包
常见于两类隐藏限制：
-
platform配置锁死 PHP 版本：比如"platform": {"php": "8.1.0"}，但你要装的包最低要求 PHP 8.2 ——why-not不提示平台不兼容，得看composer update --dry-run -v最后几行的Ignoring platform requirements提示 -
conflict字段被忽略：有些包在自己的composer.json里写了"conflict": {"laravel/framework": ">=10.0"}，它不会出现在why-not路径里，但会直接阻断安装；用composer prohibits vendor/package:version才能暴露
真正卡点往往不在主依赖，而在某个 require-dev 里的调试工具悄悄拉高了 PHP 要求，或者某个私有包的 conflict 规则没同步更新。
