插件没被加载是因为未满足三个硬性条件：type必须为"composer-plugin"、主类实现PluginInterface、autoload正确映射；漏任一条件则静默忽略，无报错提示。
插件没被加载？先确认它是否真进了 Composer 的扫描范围
Composer 插件不生效，90% 的情况不是代码写错了，而是压根没被识别——它根本不会报错，也不会提示“跳过”，只是静默忽略。必须同时满足三个硬性条件：type 是 "composer-plugin"、主类实现 PluginInterface、autoload 能正确定位到该类。
常见漏点：
-
"type": "composer-plugin"写成"composer_plugin"或"Composer-Plugin"（大小写/连字符错误） -
autoload中 PSR-4 映射末尾缺反斜杠，比如"MyPlugin\": "src/"写成"MyPlugin": "src/" -
src/Plugin.php里namespace和 autoload 声明不一致，比如写了namespace MyPlugin\Sub;却在 autoload 里映射"MyPlugin\": "src/" -
composer-plugin-api版本不匹配：Composer 2.x 项目写了"^1.0"，直接拒载
怎么知道插件到底有没有被加载？别猜，用命令验证
运行 composer show --plugins（Composer ≥ 2.2），它会列出所有已成功加载的插件及其版本。如果插件不在列表里，说明加载失败；如果在但行为异常，再查事件监听或逻辑。
更细粒度的诊断方式：
- 加
--verbose运行任意命令（如composer install --verbose），观察输出中是否有插件初始化日志，比如Loading plugin MyPlugin\Plugin - 运行
composer diagnose --verbose，末尾会明确提示兼容性问题，例如：Plugin hirak/prestissimo is not compatible with Composer 2 - 若怀疑是 PHP 环境限制，单独检查关键函数：
php -r "var_dump(function_exists('proc_open'));"、php -r "var_dump(function_exists('pcntl_signal'));"
监听事件不触发？确认你监听的是插件事件，不是脚本事件
post-install-cmd 是脚本事件（script event），插件不能直接监听它。你真正该注册的是插件事件（plugin event），比如 PostInstallEvent，它在 vendor 写入完成、autoload.php 生成前触发。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
监听写法必须严格：
- 事件名是字符串
'post-install-cmd'，不是常量ScriptEvents::POST_INSTALL_CMD - 回调函数签名必须为：
public function onPostInstall(CommandEvent $event)，类型提示不能少 - 注册方式：
$composer->getEventDispatcher()->addListener('post-install-cmd', [$this, 'onPostInstall']) - 想改 autoload 逻辑？用
PostAutoloadDumpEvent，此时$event->getComposer()->getAutoloadConfig()已可读写
读取 extra 配置总是 null？链式取值前必须判空
$composer->getPackage()->getExtra() 返回的是根项目 composer.json 中的 extra 字段，但它可能为 null，且子包里的 extra 不会透传给父项目插件。
正确写法：
$extra = $composer->getPackage()->getExtra() ?? [];- 再取嵌套字段：
$extra['my-plugin']['enabled'] ?? false - 所有键访问前都得做存在性判断，比如
isset($extra['my-plugin']['path']) ? $extra['my-plugin']['path'] : 'default/path'
插件配置失效往往不是逻辑错，而是 extra 没声明、拼写错、或压根没写进根项目的 composer.json 里——它不会从依赖包里自动合并上来。
