Composer插件需满足"type": "composer-plugin"、实现PluginInterface、extra.class正确指向且可自动加载三条件才被激活；仅composer require不生效，必须通过install/update触发加载并验证日志输出。
composer require 安装的是包，不是插件
Composer 本身没有“安装插件”这个动作——你执行 composer require my/plugin-package，实际只是把一个类型为 composer-plugin 的普通包放进 vendor/，它是否生效，取决于这个包是否实现了 PluginInterface 并被 Composer 主程序识别和激活。
换句话说：composer require 不等于“启用插件”，它只负责下载和注册。真正起作用的是 Composer 启动时自动扫描并调用插件的 activate() 方法。
- 插件包必须在
composer.json中声明"type": "composer-plugin" - 必须通过
extra.class指定主类路径，且该类要实现Composer\Plugin\PluginInterface - Composer 2.x 默认启用插件；若被禁用（如设置了环境变量
COMPOSER_DISABLE_PLUGINS=1），即使装了也完全不加载
如何确认插件已加载并运行
装完后不能只看 vendor/ 里有没有文件，得验证它是否真被 Composer 调用。最直接的方式是加 -v 参数触发详细日志：
composer install -v
观察输出中是否有类似 Loading plugin My\PlugIn 或 Running custom installer... 的行。没有就说明插件没被识别——常见原因包括：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer.json里漏写"type": "composer-plugin"（这是硬性要求） -
extra.class值写错命名空间或类名（比如少个反斜杠、大小写不一致） - 插件类所在 PSR-4 路径没在
autoload中声明，导致 Composer 找不到类文件 - PHP 版本不兼容：插件依赖的
composer-plugin-api版本与当前 Composer 不匹配（如插件要求^2.3，但你的 Composer 是 2.1）
插件 vs 普通扩展包：关键区别在哪
普通包（如 monolog/monolog）靠 autoload 注册类，供你在代码里 use；插件则绕过应用层，在 Composer 运行时底层介入流程。典型差异：
- 插件能监听事件（如
PackageEvents::PRE_INSTALL_CMD），普通包做不到 - 插件可替换安装器（
InstallationManager::addInstaller()），改变包怎么落地到磁盘 - 插件能注册新命令（
$io->write('my:command')+CommandProviderInterface），普通包不行 - 插件类必须在 Composer 初始化早期就加载，因此不能依赖
vendor/autoload.php（它自己就是 autoloader 的一部分）
误把插件当普通包用，比如在业务代码里 new MyPlugin()，会失败——它不是设计来被你手动实例化的。
调试插件时最容易忽略的点
插件逻辑跑在 Composer CLI 进程里，不是你的 Web 或 Artisan 请求进程。这意味着：
-
var_dump()或dd()会直接打到终端，但可能被 Composer 日志级别过滤掉（默认IOInterface::NORMAL） - 插件里写的
file_put_contents('/tmp/log', ...)是有效的调试手段，比 echo 更可靠 - 不要在
activate()里做耗时操作（如远程 HTTP 请求），它会拖慢所有composer install/update - 插件修改了安装行为（比如重定向
vendor/bin到项目根目录），记得检查composer.json的bin-dir配置是否冲突
真正麻烦的从来不是“怎么装”，而是“为什么没跑”。盯住 composer install -v 输出，比翻文档快十倍。
