开发依赖报错90%是require-dev拉低主依赖版本、引入PHP扩展冲突或minimum-stability不兼容，须用composer why-not和composer show --tree分析真实依赖链，而非盲目删vendor重试。
直接上结论：开发依赖（require-dev）报错，90% 不是包本身有问题，而是它悄悄拉低了主依赖版本、引入了不兼容的 PHP 扩展要求，或和 minimum-stability 冲突——必须用 composer why-not 和 composer show --tree 看真实依赖链，而不是删 vendor 重试。
为什么 require-dev 安装总卡住
开发依赖常被当成“只在本地用”，但 Composer 不区分运行环境，它会把 require-dev 的全部约束纳入全局 SAT 求解。常见表现：
-
Your requirements could not be resolved报错里出现phpunit/phpunit、mockery/mockery、sebastian/exporter等，基本就是它们锁死了某个底层组件（比如symfony/console或guzzlehttp/guzzle）的老版本 - 报
ext-xml * is missing或ext-simplexml * is missing，但你确认已装——其实是某个require-dev包（如phpunit/phpunit）强制要求了更高版本的扩展，而你系统 PHP 是旧版 -
composer install成功，但composer require --dev phpunit/phpunit:^10失败，因为根composer.json里写了"php": "7.4"，而 PHPUnit 10 要求 PHP 8.1+
composer why-not 必须带版本号执行
看到报错里有 don’t install vendor/package:version（比如 don’t install phpunit/phpunit:^10.0），立刻执行对应命令，不能省略版本号：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 正确：
composer why-not phpunit/phpunit:^10.0—— 输出倒序阻塞链，从最后一行（Root package）往上读 - 错误：
composer why-not phpunit/phpunit（不带版本）—— 可能返回空，误判为“没冲突” - 如果输出为空，优先检查
require-dev是否含隐式约束：运行composer show --tree | grep -i "phpunit\|mockery"，看是否通过间接依赖引入了老版本
换源、清缓存、删 lock 文件的顺序不能乱
开发依赖报错常伴随镜像失效或缓存污染，但操作顺序错了反而加重问题：
- 先确认镜像生效：
composer config -g repo.packagist输出必须是完整 JSON，且url末尾有/（如https://mirrors.aliyun.com/composer/） - 再清缓存：
composer clear-cache—— 否则旧 provider 地址仍会被复用 - 最后删文件：只删
composer.lock，**不要删vendor/**；删了vendor/再跑install，会复现同样错误，因为composer.lock里硬编码了旧解析结果 - 验证效果：
composer install -vvv 2>&1 | grep -i "host\|mirrors"，第一行域名必须是你配置的镜像地址
升级 require-dev 包必须加 --with-dependencies
开发依赖之间耦合极强，单独更新一个包（如 phpunit/phpunit）却不更新它的子依赖（如 sebastian/exporter），大概率失败：
- 错误写法：
composer update phpunit/phpunit—— 默认拒绝更新其子依赖，sebastian/exporter仍卡在 4.x，而 PHPUnit 10 需要 5.x - 正确写法：
composer update phpunit/phpunit --with-dependencies—— 只动它和直系依赖，不波及monolog或guzzle - 安全预演：
composer update phpunit/phpunit --with-dependencies --dry-run，确认改动范围再执行 - 执行后立刻
git diff composer.lock，如果变更涉及十几个包，说明约束没控住，得回退并检查platform配置
真正麻烦的从来不是“装不上”，而是“装上了但运行时报错”——比如 phpunit 升到 10 后，illuminate/support 被连带升到 v11，而你的 Laravel 还是 v9。这种隐性升级链，只有 composer show --tree 能暴露出来。
