插件降级必须先于依赖降级执行：因插件在composer install/update最早阶段加载并介入解析，若先降级主依赖，新插件逻辑可能已生成锁文件，导致插件版本变更被忽略或报错；正确顺序是先composer require插件旧版--no-update，再composer update --with-all-dependencies。
插件降级必须先于依赖降级执行
Composer 插件（如 hirak/prestissimo、composer-unused）不是普通包，它们在 composer install 或 update 的最早阶段就被加载并介入依赖解析。如果你先降级了主依赖（比如 laravel/framework），再试图降级插件，Composer 可能已用新插件逻辑完成了锁文件生成，导致插件版本变更被忽略或引发解析错误。
正确顺序只有一条：先让插件版本就位，再跑依赖更新。
- 先执行
composer require hirak/prestissimo:^0.4.0 --no-update（假设你要回退到 v0.4） - 再执行
composer update --with-all-dependencies，此时插件已载入旧版逻辑，整个依赖图会按其约束重新计算 - 如果插件本身有依赖（如依赖特定版本的
composer-plugin-api），--with-all-dependencies会一并处理，避免“插件装上了但不生效”的静默失败
插件版本与 Composer 主版本强绑定
插件不是向后兼容的。例如 composer-unused v0.12+ 仅支持 Composer 2.5+，而 prestissimo v0.4 最后一个支持 Composer 1.x 的版本。你不能在 Composer 2.7 下安装 prestissimo v0.3 —— 它会在加载时直接报 Plugin installation failed，因为 composer-plugin-api 版本不匹配。
查清兼容关系的实操方式：
- 运行
composer show hirak/prestissimo看其requires字段是否含composer-plugin-api: ^1.0（对应 Composer 1.x）或^2.0（对应 Composer 2.x） - 用
composer --version确认当前 Composer 主版本，再查插件 GitHub Releases 页面的compatibility标签或CHANGELOG - 不要依赖
composer require vendor/plugin:old-version盲试 —— 失败时错误信息往往只显示Plugin could not be initialized，没说具体哪条约束断了
插件降级后必须重生成 lock 文件
插件参与依赖解析，但它的版本不会写进 composer.lock 的 packages 区块，而是记录在 plugins 字段（Composer 2.2+）或完全不落盘（1.x）。这意味着：即使你成功降级了插件，只要 composer.lock 是由高版本插件生成的，它内部的依赖决策路径可能已固化，导致 composer install 仍沿用旧策略。
安全做法是强制刷新解析上下文：
- 删掉
composer.lock：rm composer.lock - 清空
vendor/：rm -rf vendor - 再执行
composer install—— 此时插件以新版本加载，从头解析所有依赖，包括 platform 配置和虚拟包映射 - 验证是否生效：运行
composer diagnose，观察输出中是否出现插件名及其声明的钩子（如pre-autoload-dump）
插件配置项降级容易被忽略
有些插件通过 composer.json 的 config 或 extra 字段控制行为，比如 phpstan/extension-installer 依赖 extra.phpstan 结构，laminas/laminas-zendframework-bridge 依赖 extra.laminas。这些配置字段本身没有版本号，但不同插件版本对字段结构的校验严格度不同。
降级后典型问题：
- 旧版插件拒绝读取新版才支持的配置键（如
extra.phpstan.level在 v1.0 中不存在，v1.2 才引入） - 配置值格式变化（如布尔值改写成字符串、数组结构扁平化），导致插件静默跳过或报
Invalid configuration - 解决方法不是删配置，而是对照插件文档的
vX.Y.Z版本页，找到该版本接受的extraschema 并手工对齐
最稳妥的方式是：降级插件后，先删掉 composer.json 中所有该插件相关的 extra 和 config 字段，再逐步加回，每加一项就跑一次 composer install 验证。
