插件类找不到需先查 vendor/composer/autoload_classmap.php 是否包含该类；若无，则检查 composer.json autoload 配置、路径结尾斜杠、文件扩展名是否合规。
插件类找不到：先查 vendor/composer/autoload_classmap.php 里有没有它
Composer 插件本质是普通 PHP 类，靠自动加载机制载入。报 Class 'SomePlugin\Installer' not found，第一反应不是插件写错了，而是这个类压根没进 classmap 表。打开 vendor/composer/autoload_classmap.php，搜索插件主类名（比如 MyVendor\MyPlugin\ComposerInstaller）——没出现，说明 Composer 根本没扫描到它。
常见原因包括：
-
composer.json中"autoload"配置写在插件包自己的根目录下，但你执行composer install的位置不是该包根目录（比如你在项目里require了它，却去插件源码目录下跑 dump-autoload） - 插件包的
composer.json没配autoload字段，或写了psr-4却漏了末尾\，例如"MyPlugin\": "src"→ 应为"MyPlugin\": "src/" - 插件代码里用了
.php5或.inc扩展名，而 Composer 默认只扫.php
composer install 不触发插件：确认 type 是 composer-plugin 且已启用
插件必须声明 "type": "composer-plugin"，否则 Composer 当作普通库处理，不会注册它的 PluginInterface 实现类。检查插件包的 composer.json，确保有这一行；再确认项目 composer.json 的 require 或 require-dev 里确实引入了它。
另外，插件是否真被启用，取决于它是否出现在 vendor/composer/autoload_plugins.php 中。这个文件由 Composer 自动维护，但有个前提：插件类必须能被自动加载，且实现 Composer\Plugin\PluginInterface。如果它出现在 classmap 里但没进 autoload_plugins.php，大概率是接口实现不完整或构造方法抛了异常（Composer 会静默跳过）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
插件运行时报错但无堆栈：加 -v 看加载过程，别信默认输出
Composer 插件加载失败时，默认输出常是“成功”，实际什么都没做。必须加 composer install -v 或 composer update -v，它才会打印：
- 正在加载哪些插件类（含完整路径）
- 调用
activate()时是否抛出异常（哪怕只是new \Exception()） - 插件是否注册了命令、事件监听器等扩展点
如果你的插件类在列表里出现了，但后续没任何关于它的日志，说明 activate() 方法内部提前 return 或静默失败了。这时候得手动在插件代码里加 error_log('activated') 确认执行流。
本地开发插件时反复失效：删 vendor/composer/autoload_*.php 再重生成
本地改插件代码后，composer dump-autoload 经常不生效——因为 Composer 会复用旧的 autoload_classmap.php 和 autoload_plugins.php，尤其当你用 -o 优化模式生成过。最稳妥的做法是：
- 删掉整个
vendor/composer/下所有autoload_*.php文件 - 确保当前工作目录是项目根（不是插件源码目录）
- 运行
composer dump-autoload -v，观察输出里是否包含你的插件路径和类名 - 再跑
composer install -v，看插件是否进入激活流程
插件加载链路比业务类更脆弱：它依赖 classmap 查表 → 实例化 → 调用 activate() → 注册事件。任一环节断开，都不会报错，只会“假装不存在”。盯住 -v 输出里那几行关键日志，比猜快得多。
