答案是composer why-not vendor/package:version为第一反应动作——它从composer.json逆推阻塞链，最上行“root package requires”常暴露手动约束过窄（如"php": "7.4"），而插件冲突需查其packagist/github兼容性。
直接看 composer why-not 输出最上面一行，它指明了谁在卡住版本——90% 的冲突根源就藏在这里，不是网络问题，也不是权限问题。
为什么 composer why-not 比 composer why 更关键
报错里出现 Conclusion: don’t install vendor/package:version 时，composer why 只告诉你“谁依赖了它”，但不体现版本限制；而 composer why-not 是逆向推导：从你想装的版本出发，一层层回溯谁锁死了范围。比如运行 composer why-not monolog/monolog:2.9.0，输出第一行通常是 Root package requires php: ^7.4，说明你 composer.json 里写的 PHP 版本太旧，新包已放弃支持。
- 别用
composer depends替代，它只查依赖路径，不查约束条件 - 如果阻塞源是某个插件（如
spatie/laravel-backup），先去它的 Packagist 页面确认是否已有适配新版 Laravel 的 release，而不是立刻删掉 - 输出里越靠上的条目，约束力越强；越靠下的，往往是间接传递的限制
composer update 定点升级时必须带的三个参数
默认 composer update 会重算整个依赖图，极易把稳定子依赖（比如 guzzlehttp/guzzle 从 7.x 升到 8.x）一并拉高，导致 new GuzzleHttp\Client() 直接报错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须写死包名，不加引号、不加波浪号：
composer update monolog/monolog，不是composer update "monolog/monolog:^3" - 加上
--with-dependencies：只允许升该包及其直系依赖，不会动phpunit这类远亲 - 执行前加
--dry-run预览：composer update monolog/monolog --with-dependencies --dry-run，确认改动范围再落地
PHP 版本不匹配时，config platform.php 是个陷阱
报错 requires php ^8.1 but your PHP version (7.4.33) does not satisfy that requirement，根本原因是 Composer 调用了当前 shell 的 php -v 结果做校验，不是配置写错了。
- 别用
--ignore-platform-reqs硬过——vendor里会混入 PHP 8.1 语法（如match表达式），本地一跑就ParseError - Linux/macOS 下明确调用目标二进制：
/usr/bin/php8.1 composer install - Windows 下用完整路径：
"C:\php\php81\php.exe" composer install -
config platform.php只应在打包部署场景用（比如 PHP 7.4 机器上生成适配 PHP 8.2 的vendor），且必须同步更新composer.lock并验证运行时行为
真正难处理的从来不是报错文字本身，而是那个被层层包裹、最终落在 composer.json 里某一行看似无害的版本约束——它可能来自半年前一次临时调试，也可能来自合并分支时没清理干净的残留声明。
