Composer install 报“版本不匹配”90%因 composer.lock 与本地环境（PHP 版本、扩展、platform 配置、镜像源）不兼容，删 vendor 和 composer.lock 重装最高效；报 “requirements could not be resolved” 实为平台校验失败，非包冲突。
Composer install 报“版本不匹配”，90% 是 composer.lock 与当前环境不兼容，不是 composer.json 写错了——直接删 vendor 和 composer.lock 再重装，比调约束快得多。
报错 “Your requirements could not be resolved” 其实是环境校验失败
这个提示不是说包之间打架，而是 composer.lock 里记录的依赖快照，和你本地 PHP 版本、扩展、config.platform.php 配置对不上。比如：
-
composer.lock里某个包标着"php": ">=8.1"，而你本地是php -v输出7.4.33 -
composer.json里写了"config": {"platform": {"php": "8.2.10"}}，但你只装了8.2.9—— 少一个 patch 号也会失败 - CI 流水线用阿里云镜像源生成的
composer.lock，你本地没配镜像，请求地址和 checksum 对不上
验证是否平台限制导致：加 --ignore-platform-reqs 试一次。如果成功，说明就是环境不匹配；但别上线，它只是跳过检查，装出来的包可能一跑就 ParseError。
用 composer why-not 定位真实阻塞点
看到报错里有 don’t install monolog/monolog:2.9.0，别猜，立刻执行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer why-not monolog/monolog:2.9.0
输出是一条从下往上的链，最后一行是你 composer.json 的根声明，往上每行末尾的 (required by xxx) 就是卡点。常见情况：
- 最上面一行是
Root package requires→ 你手动写的约束太窄，比如"php": "7.4"，但新包已放弃支持 - 中间某行是
spatie/laravel-backup (required by app)→ 查它的 Packagist 页面，确认是否已有兼容新版 Laravel 的 release - 输出为空？检查
require-dev——phpunit/phpunit常拖着老版sebastian/exporter，间接锁死symfony/console
composer update 必须带 --with-dependencies
不加这个参数，composer update monolog/monolog 默认拒绝更新它的子依赖，哪怕新版本根本跑不起来。这是最容易踩的坑。
- 升版本：运行
composer update monolog/monolog --with-dependencies - 降主版本（如从
guzzlehttp/guzzle:^8.0切回7.4.5）：必须先在composer.json里写死"guzzlehttp/guzzle": "7.4.5"，再跑命令 - 加
--dry-run预览：比如composer update monolog/monolog --with-dependencies --dry-run，确认只改目标包及其直系依赖 - 执行后立刻
git diff composer.lock，如果多了十几个包，说明约束没控住，得回退
composer show --tree 比 composer.json 更可信
composer.json 是“愿望清单”，composer show --tree 才是 vendor 里真实装了什么。它能暴露你根本没意识到的间接路径：
-
composer show --tree | grep "symfony/console"看它是否标着(locked to 5.4.42) -
composer show --tree monolog/monolog | grep -A5 -B5 "guzzlehttp/guzzle"看哪条路径在拉低版本 - 看到某包标着
(replaced)或(provided)，得去它自己的composer.json里确认实际行为
复杂项目里，conflict 和 replace 字段是硬规则，不是提示——写进去了，哪怕没 require，只要其他包间接拉进来，就会触发校验失败。
