Composer插件必须在composer.json的require中声明并指定type为composer-plugin，且需检查extra配置、PHP版本兼容性、disable-plugins设置，并通过composer install -v或composer show --plugins确认是否加载成功。
composer.json 里怎么写插件配置
Composer 插件不是靠命令行临时启用的，必须在 composer.json 中声明依赖并指定类型。如果只用 composer require 装包但没配对类型，插件大概率不会生效。
- 插件包本身必须声明
"type": "composer-plugin"（由作者定义，你不用改） - 你在项目中要把它加进
require，不是require-dev（除非它明确说明仅开发时需要） - 某些插件要求额外配置，比如
extra字段下设开关或路径，不填就走默认逻辑——而默认逻辑常常是“不干活”
示例：装 hirak/prestissimo（已废弃但典型），需确保 composer.json 含：
{
"require": {
"hirak/prestissimo": "^0.3"
}
}
插件安装后为什么没反应
最常见原因是 Composer 没加载到它——不是代码问题，是 autoloader 或插件注册时机出错。
- 运行
composer install或composer update后，检查控制台是否输出类似Using version ^x.y for vendor/plugin-name，没这句基本等于没载入 - 插件类必须实现
Composer\Plugin\PluginInterface，且构造函数不能抛异常，否则 Composer 会静默跳过 - PHP 版本不匹配：比如插件用了
match表达式，但你的 CLI PHP 是 8.0 以下，composer install会失败或跳过加载 - 插件被禁用：全局配置里有
disable-plugins: true，或当前项目composer.json的config.disable-plugins设为true
怎么确认某个插件实际在运行
别信文档，看日志和行为。Composer 插件没有统一「启用状态」API，得从副作用反推。
- 加
-v参数重跑命令：composer install -v，搜索输出里有没有插件名或自定义事件名（如pre-install-cmd） - 检查插件是否监听了生命周期事件，比如修改了
vendor/autoload.php内容、生成了额外文件、或改变了下载源行为 - 用
composer show --plugins（Composer 2.2+）查看已加载插件列表；老版本只能靠composer diagnose看是否有 warning 提到插件加载失败 - 某些插件提供命令，比如
composer dump-autoload --optimize被增强后，可对比加插件前后的vendor/composer/autoload_classmap.php大小变化
插件和脚本（scripts）混用时的坑
很多人想用插件替代 scripts，结果发现事件触发顺序不对，或者插件根本收不到预期事件。
- 插件监听的是 Composer 内部事件（如
post-autoload-dump），而scripts是 shell 命令封装，两者不在同一调度层 - 如果你在
scripts里调composer install，嵌套调用下插件可能只在最外层生效，内层被忽略 - 插件无法直接读取
scripts中定义的环境变量，反之亦然；传参要用extra字段或临时文件 - 调试时别只盯
composer.json的scripts，先确认插件本身在vendor里解压完整、类文件存在、命名空间没拼错
插件机制本身不复杂，难的是 Composer 加载它的那一瞬间——没报错、没提示、也没效果，这种静默失效最容易拖慢排查节奏。
