结论：不是Composer不兼容PHP 8，而是锁死的依赖版本、composer.json中PHP声明与本地CLI版本未对齐；用composer why-not php:8.3可精准定位不支持该PHP版本的包。
直接说结论：不是 Composer 本身不兼容 PHP 8，而是你锁死的依赖版本、composer.json 中的 PHP 声明、本地 CLI 的 PHP 版本三者没对齐——90% 的报错都卡在这三点上。
怎么快速定位哪个包不支持 PHP 8
别急着删 vendor 或改配置。先用 Composer 自带命令挖根子：
-
composer why-not php:8.3（把8.3换成你实际用的版本）——它会列出所有在require.php字段里硬性声明不支持该 PHP 版本的包，比如monolog/monolog v1.26.1 requires php ^7.2 - 加
-v参数重跑安装：composer install -v，盯住输出里最后一行带requires php的依赖链，崩溃点往往就藏在倒数第二三级 - 去 Packagist 查那个包的最新版 composer.json，确认它的
require.php是否已更新为"^8.0"或"^8.3"；没更新就只能升主版本，比如从monolog/monolog:^1.0改成monolog/monolog:^2.0
为什么 composer install 卡在 “Resolving dependencies” 不动
这不是网络慢或性能差，是某些旧包的版本约束触发了 Composer 2.x 新解析器的无限回溯。典型特征：等两分钟没反应，composer update --dry-run -v 也卡在同一包上。
- 常见元凶：
guzzlehttp/guzzlev6.x、ramsey/uuidv3.x、phpunit/phpunitv8.x —— 它们的composer.json里写了类似"^7.0 || ^8.0"这种已被废弃的写法 - 临时解法：在
composer.json的conflict段手动排除："conflict": { "guzzlehttp/guzzle": "，再试 - 更稳做法：直接锁定已知兼容版本，比如
"guzzlehttp/guzzle": "^7.4"，然后只更新它：composer update guzzlehttp/guzzle
一键检测兼容性的工具怎么配才不白装
装了 phpcompatibility/php-compatibility 却没报错？大概率是没激活规则或路径错了。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
立即学习“PHP免费学习笔记（深入）”；
- 先确保插件启用：
composer config allow-plugins.dealerdirect/phpcodesniffer-composer-installer true - 全局安装后，必须指定标准：
phpcs --standard=PHPCompatibility --runtime-set testVersion 8.3 src/（src/是你的代码目录，8.3是目标 PHP 版本） - 别漏掉 vendor 里的自定义包：如果项目里有自己写的扩展或私有库，也要一并扫进去，否则检测结果不全
- 注意：这个工具只查代码语法和函数调用兼容性，不查
composer.json里的require.php约束——那是composer why-not的活
升级后 dump-autoload -o 报错 “Unrecognized option: o” 怎么办
这不是 autoload 失效，是 Composer 2.9+ 已把优化编译设为默认行为，-o 参数被彻底移除。
- 直接删掉
-o，运行composer dump-autoload即可——效果一样，甚至更快 - 如果你用的是 Laravel，
php artisan optimize:clear也会自动触发新版 autoload 生成，不用额外干预 - 旧脚本里还留着
dump-autoload -o？赶紧 grep 删掉，否则 CI 流水线会崩
真正容易被忽略的点是：CLI 的 PHP 版本、composer config platform.php、php -v 输出这三者必须完全一致。哪怕只差一个小数点，比如 8.3.0 和 8.3.5，Composer 都可能拿旧 lock 文件硬塞新环境，然后报一堆“requires php ^8.3 but your version is 8.3.5”这种看似矛盾的错。
