composer插件必须全局安装或通过path repository显式引入才能生效；常见失效原因包括type非composer-plugin、未实现plugininterface、extra.class配置错误或事件名不匹配。
Composer 插件不能像普通包一样“在项目里 require 后就生效”——它必须全局安装，或通过 path repository 在项目中显式引入并确保被 Composer 主进程加载。
插件为什么装了却不触发 activate()？
最常见的假象是：执行 composer global require vendor/plugin 后运行 composer install，却没看到任何输出。这不是 Composer 忽略你，而是插件根本没被扫描到。
- 检查
composer global show --format=json输出里该包的"type"是否为"composer-plugin"；不是就只是个普通库 - 确认插件类是否真正实现了
ComposerPluginPluginInterface（注意命名空间和接口全名），少一个字母或拼错接口名都会静默失败 -
extra.class字段必须存在且指向可 autoload 的完整类名，比如"AcmeComposerPluginMyPlugin"，不能是短名或相对路径 - 用
file_put_contents('/tmp/plugin-activated', 'yes')在activate()里打日志，再执行composer -V验证——这是唯一靠谱的激活检测方式
全局安装 vs 项目级 require，到底该选哪个？
绝大多数 Composer 插件（如 hirak/prestissimo、dealerdirect/phpcodesniffer-composer-installer）必须全局安装，否则不会被加载。
- 全局安装命令是：
composer global require vendor/plugin；路径默认为~/.composer，需确保该目录可写 - 项目级
composer require vendor/plugin通常无效——因为插件需要在依赖解析前介入，而项目依赖是在插件注册之后才读取的 - 例外情况只有本地开发测试：用
pathrepository +require-dev，但必须配好 autoload 和extra.class，且每次改代码后要手动composer dump-autoload
监听事件时，名字写错一个字符就失效
事件名不是随便写的字符串，而是 Composer 内置常量，大小写、下划线、前缀都必须完全匹配。
- 正确写法：
ScriptEvents::POST_INSTALL_CMD，不是post-install、post_install_cmd或PostInstallCmd - 订阅方法必须以
on开头，比如onPostInstallCmd()，参数类型要是CommandEvent或对应事件类 - 别在事件回调里
throw异常来“中断流程”，这会让整个composer install报红退出，用户只会看到堆栈，不是你的提示 - 如果想读配置，得从 root package 手动取：
$composer->getPackage()->getExtra()['my-plugin']['enabled'] ?? false，getExtra()可能返回NULL，不判空会报 Notice
插件机制本身很轻，但 Composer 加载它的路径非常窄：类型声明、接口实现、autoload 路径、extra.class、事件常量——任何一个环节出偏差，都不会报错，只会安静地跳过。调试时别猜，直接在 activate() 里写文件日志，这是最省时间的方式。