Composer插件通过依赖声明自动加载执行，需同时满足：type为"composer-plugin"且类实现PluginInterface；未生效常见原因包括Composer版本低于2.2、PHP扩展缺失、disable-plugins启用或仅在update触发。
Composer 自动检测插件（即 Composer Plugin）不是靠“安装”触发的，而是由项目 composer.json 中声明的依赖自动加载并执行——你只要 require 一个带 "type": "composer-plugin" 的包，它就会在 composer install 或 composer update 过程中被识别、实例化并运行。
怎么确认某个包是 Composer 插件？
不能只看名字或文档。必须打开它的 composer.json 文件，检查是否同时满足以下两点：
-
"type"字段值为"composer-plugin"（不是"library"或"project"） -
"extra"或"autoload"中定义了插件类路径，且该类实现了Composer\Plugin\PluginInterface
例如 hirak/prestissimo（已归档）或 phpstan/extension-installer 都是典型插件：前者改写下载器，后者自动启用 PHPStan 扩展。如果你 composer require phpstan/extension-installer，后续 composer install 就会自动注册所有已 require 的 PHPStan 扩展，无需手动配置。
为什么 composer require xxx 后插件没生效？
常见原因不是命令失败，而是插件未被触发执行。排查要点：
- 当前 Composer 版本太低（
composer --version输出低于 2.2）：旧版不支持部分插件生命周期钩子，比如pre-autoload-dump；升级用composer self-update - 插件要求的 PHP 版本或扩展缺失：例如某插件依赖
ext-json，但你的 CLIphp -m里没列出，它会静默跳过加载 - 插件被禁用：检查项目根目录是否有
composer.json中的"config": { "disable-plugins": true }，或全局设置了COMPOSER_DISABLE_PLUGINS=1 - 插件只在
update阶段运行：有些插件（如版本智能升级助手）只响应composer update，install不触发——别用install测试
如何调试插件是否加载成功？
最直接的办法是加一句诊断命令：
composer diagnose --verbose
输出里会列出已加载的插件及其类名。如果没出现你刚 require 的包，说明它根本没被识别。这时再查：
- 运行
composer show xxx/yyy（替换为包名），看types字段是不是composer-plugin - 进
vendor/xxx/yyy/目录，检查是否存在composer.json且内容合法（用json_decode(file_get_contents('composer.json'), true)快速验证） - 插件类文件是否真能被自动加载？临时加一行
echo "PLUGIN LOADED\n";到其构造函数里，再跑一次composer update看终端有没有输出
插件机制本身不复杂，但容易卡在环境对齐上：PHP CLI 扩展、Composer 版本、锁文件状态、甚至 vendor/autoload.php 是否被重新生成——这些环节任意一个断掉，插件就只是个普通依赖，不会自动“活”起来。
