composer版本冲突本质是依赖图中存在无法共存的版本断点，须用composer why-not定位阻塞链，再通过--with-dependencies精准升级或隔离require-dev冲突包解决。
多插件并行开发时的 Composer 版本冲突，根本不是“装不上”，而是依赖图里出现了无法共存的版本断点——你不能靠删 vendor 或加 --ignore-platform-reqs 绕过去，必须让 Composer 看清你真正想跑的环境和约束边界。
composer why-not 是你第一个该敲的命令
报错里只写 “Conclusion: don't install laravel/pint:^1.13”，但没说谁在拦。这时候别猜，直接问：
composer why-not laravel/pint:^1.13
它会输出真实阻塞链，比如：
myapp/core dev-main requires php ^8.0<br>laravel/pint ^1.13 requires php ^8.1
或更隐蔽的：
acme/sdk v2.4.0 requires symfony/console ^5.4<br>laravel/pint ^1.13 requires symfony/console ^6.2
关键点：
-
why-not查的是“当前已解析状态”下谁在拒绝目标版本，不是查你本地有没有装 - 如果输出为空，说明冲突不在已安装包里，可能来自
require-dev中某个工具（如phpunit/phpunit拉了旧版sebastian/exporter） - 别信报错末尾的 “found x packages with conflicting constraints” —— 那是结论，不是路径
composer update --with-dependencies 要精准指定包名
你想升级 spatie/laravel-ray，但卡在 symfony/var-dumper 版本不兼容。默认 composer update spatie/laravel-ray 很可能失败，因为 Composer 不会自动升级它的子依赖。
正确做法是：
composer update spatie/laravel-ray --with-dependencies
这会让 Composer 主动重算 spatie/laravel-ray 及其所有直系依赖（比如它 require 的 symfony/var-dumper、monolog/monolog），但不会去碰 phpunit 或 laravel/framework 这类无关项。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
注意：
- 不能写
composer update "spatie/laravel-ray:^1.30"—— 引号 +^会让 Composer 尝试找最新兼容版，反而扩大搜索空间 - 如果连
--with-dependencies都失败，说明冲突来自更上层（比如laravel/framework锁死了symfony/*全家桶），那就得先动框架 - 升级后立刻
git diff composer.lock，确认只有预期变更，避免 CI 环境意外漂移
PHP 版本不一致时，别改 config.platform.php 就跑 install
你在 PHP 7.4 机器上开发，但插件要求 PHP 8.1。看到报错 “requires php ^8.1 but your PHP version (7.4.33) does not satisfy that requirement”，第一反应不是改 composer.json 里的 platform，而是确认执行环境：
- Linux/macOS：用完整路径调用目标 PHP，例如
/usr/bin/php8.1 composer install - Windows：用
"C:\php\php81\php.exe" composer install - CI 脚本中必须前置
php -v打日志，否则你永远不知道实际生效的是哪个版本
config.platform.php 只在极少数场景有用：
- 你在 PHP 7.4 机器上，要为 PHP 8.2 生产环境打包部署包（
vendor目录需提前生成） - 你 100% 确认所有包都已验证过兼容性，且团队能统一维护这个配置
禁用场景更常见：
- 本地 PHP 是 7.4，却设
"platform": {"php": "8.2.0"}后直接跑php artisan serve——match表达式一执行就ParseError - 把这个配置提交到 Git，队友用 PHP 8.0 开发，结果
composer install成功但运行时报错
冲突来自 require-dev 时，别让它污染主依赖树
很多插件冲突其实不来自业务代码，而是测试/开发工具悄悄拉进来的。比如：
-
orchestra/testbench（Laravel 测试框架）硬绑laravel/framework:^9.0 -
phpunit/phpunit:^9依赖sebastian/environment:^5.0，而主项目用了^6.0
解决思路不是升级所有 dev 工具，而是隔离：
- 把
require-dev中与主项目冲突的包移到tools目录下单独管理（用composer create-project初始化一个最小工具链） - 用
composer install --no-dev在生产/CI 中跳过它们，避免干扰依赖解析 - 检查
composer show -t | grep -A5 -B5 'conflict-package'，确认那个包是否真的被主逻辑需要
复杂点在于：Composer 的 SAT 求解器在遇到 conflict、replace 或超过 30 个包时，计算时间会指数增长。一旦 Resolving dependencies 卡住超过 2 分钟，基本可以确定是依赖图太深，而不是网络或缓存问题。
