composer插件需同时满足三条件才生效：插件包composer.json声明"type": "composer-plugin"、项目require该包并执行install/update、extra.class指向实现plugininterface且activate签名正确的类。
Composer 插件不是“装上就能用”的工具包，它本质是让代码能干预 Composer 自身行为的钩子系统——只有满足硬性条件、被正确加载、并在生命周期里注册监听或命令，才真正起作用。
为什么 composer require 后插件完全没反应
因为 composer require 只改 composer.json 和 composer.lock，不触发任何插件逻辑。插件加载发生在 composer install 或 composer update 阶段，且必须同时满足三个条件：
-
"type": "composer-plugin"出现在插件包自身的composer.json里（不是你项目里的） - 你的项目
composer.json中已将该包写进require或require-dev，并执行过install/update -
"extra": { "class": "My\Plugin" }指向的类存在、可自动加载、实现Composer\Plugin\PluginInterface，且activate()方法签名严格匹配（activate(Composer $composer, IOInterface $io)）
常见静默失败原因：autoload 路径拼错、类名大小写不一致、composer-plugin-api 版本与当前 Composer 主版本不兼容（2.x 项目不能 require ^1.1）。
Composer 2.2+ 报错 “Plugin installation is disabled” 怎么办
这是强制安全策略，不是 bug。从 Composer 2.2 开始，默认禁用所有插件，必须显式声明允许列表：
- 在项目根目录
composer.json的**根级**添加"allow-plugins"字段，值为字符串数组，例如："allow-plugins": ["symfony/flex", "phpstan/extension-installer"] - 包名大小写敏感，不可缩写、不可通配（
"flex"或"*"都无效） - 若使用
composer global require安装插件，还需在~/.composer/config.json中配置config.allow-plugins
漏掉关键插件（比如 symfony/flex）会导致 recipe 不执行、配置不自动注入——这不是插件坏了，是你没放行。
插件加载成功但自定义命令不显示在 composer list 中
插件加载 ≠ 命令注册。要让 composer xxx:yyy 可用，必须额外满足两层条件：
- 插件类需同时实现
Composer\Command\CommandProviderInterface -
getCommands()方法必须返回一个Composer\Command\BaseCommand实例数组（不能是普通对象或字符串）
验证方式很简单：composer list | grep xxx。没输出，说明命令根本没暴露；有输出但执行报错，则问题在命令类内部（比如构造函数依赖未解析、$this->getComposer() 返回 null 等）。
本地开发改了插件代码却一直不生效
Composer 缓存插件实例，不会自动感知文件变更。最常卡在这几步：
- 删掉
vendor/composer/autoload_psr4.php和vendor/composer/autoload_classmap.php，强制重建 autoloader - 运行
composer dump-autoload -o确保新路径生效 - 必须重新运行
composer install（不是require），否则旧版本仍驻留在内存
特别注意：插件类中的路径操作别依赖 getcwd() 或相对路径，要用 $composer->getConfig()->get('vendor-dir') 或 $composer->getPackage()->getName() 判断上下文是否有效——CI 环境下工作目录可能完全不是你预期的位置。
