Composer 2.x require时插件依赖解析失败，应先删lock和autoload.php，再用composer require插件名:^版本 --with-all-dependencies；若仍失败，需切换至匹配插件API的Composer版本（如1.x）执行命令，因platform配置无法绕过插件API校验。
composer require 时如何让插件按旧版规则解析依赖
Composer 2.x 默认启用更严格的依赖解析策略，部分老插件（如 wikimedia/composer-merge-plugin 1.4.x）在 require 阶段就会报错“package not found”或“no matching package”，本质是它生成的 composer.lock 字段（如 plugin-api-version）与当前 Composer 版本不匹配。不是插件写错了，而是解析器版本不认。
临时降级兼容性模式最直接的方式是加 --with-all-dependencies 并显式指定插件版本：
- 先删掉已失败的尝试：
rm -f composer.lock vendor/autoload.php - 运行：
composer require wikimedia/composer-merge-plugin:^1.4 --with-all-dependencies - 如果仍失败，说明当前 Composer 是 2.5+ 且插件 1.4 不支持，必须切回 Composer 1.x 执行该命令（见下节）
切换 Composer 版本以适配插件 API
插件的 composer.json 中若声明 "require": {"composer-plugin-api": "^1.0"}，它只接受 Composer 1.x 运行时；而 "^2.0" 则只兼容 Composer 2.x+。强行用高版本装低 API 插件，composer install 会跳过插件加载，但 composer update 仍可能报错。
可靠做法是用完整路径调用对应版本的 Phar：
- 下载 Composer 1.10.22：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" && php composer-setup.php --filename=composer1.phar --version=1.10.22 - 安装插件：
php composer1.phar require wikimedia/composer-merge-plugin:^1.4 - 后续所有操作（
install/update）都必须用同一版本的php composer1.phar，否则 lock 文件会混写
为什么 config.platform.php 不能解决插件兼容性问题
config.platform.php 只影响包的「版本选择」，不改变插件本身的加载机制。它告诉 Composer：“假装我跑在 PHP 7.4 上”，但不会让 Composer 1.x 的插件在 Composer 2.x 进程里被识别——因为插件注册发生在 PluginManager::load() 阶段，该阶段由 Composer 主程序版本硬编码控制。
常见误操作：
- 在
composer.json里加"config": {"platform": {"php": "7.4.0"}}后仍装不上composer-merge-plugin1.4 → 无效，平台配置不干预插件 API 校验 - 执行
composer self-update --1→ 已废弃，2025 年后多数发行版会忽略该参数或报错 - 改
vendor/composer/autoload_static.php手动注册插件 → 运行时会被 Composer 自动覆盖，下次install就失效
插件安装后如何验证是否真正生效
别只看 composer require 是否返回 success。插件是否挂载成功，得查两个地方：
- 运行
composer show --plugins，输出中必须出现插件名和版本（如wikimedia/composer-merge-plugin 1.4.1） - 检查
vendor/composer/autoload_plugins.php，里面应有该插件的类路径映射，且无class not found报错 - 最关键的：执行
composer dump-autoload -v，观察日志里是否有Merge plugin: including ...类似行；没有就说明没触发
很多项目卡在最后一步——插件装上了，但 extra.merge-plugin.include 路径写错或文件不存在，导致 dump-autoload 时静默跳过，还以为生效了。
