Composer 不自动发现模块化类，必须显式配置 PSR-4 并手动执行 dump-autoload；post-autoload-dump 是插件加载关键节点，此时依赖路径已确定且 autoload 配置已读取，可安全扫描并注入新插件路径。
Composer 本身不自动发现模块化类，必须靠显式配置 + 手动触发生成映射；所谓“动态发现”其实是 PSR-4 命名空间约定 + composer dump-autoload 配合事件钩子实现的伪动态。
为什么 post-autoload-dump 事件是插件加载的关键节点
插件包安装或更新后，Composer 会触发 post-autoload-dump 事件，这是唯一可靠的时机去扫描新注册的插件类——因为此时 vendor/autoload.php 尚未最终写入，但所有依赖路径已确定，插件的 composer.json 中的 autoload 配置已被读取。
- 主程序可在该事件中执行自定义脚本，遍历
vendor/*/*/composer.json，提取插件声明的 PSR-4 前缀（如"MyPlugin\": "src/"） - 不能依赖运行时扫描文件系统找类——Composer 不解析代码，只认配置声明的路径
- 若插件未在自身
composer.json中声明 autoload 规则，即使文件存在，也不会被主项目加载 - 事件脚本需调用
composer dump-autoload或直接操作ClassLoader实例注入路径，否则改动不生效
PSR-4 是插件类发现的唯一可靠方式
classmap 和 files 不适合插件场景：前者需手动维护路径、无法随插件增删自动更新；后者只加载函数/常量，不能用于类实例化。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 插件包必须在
composer.json的autoload字段中声明 PSR-4 映射，例如："autoload": {"psr-4": {"Acme\Widget\": "src/"}} - 命名空间末尾必须带反斜杠
，写成"Acme\Widget"（无反斜杠）会导致匹配失败 - 路径值必须以斜杠结尾（如
"src/"），否则拼接时会把类名AcmeWidgetButton错误解析为srcButton.php - 主项目无需修改自身
composer.json，只要插件包被require进来，其 autoload 规则就会被合并进最终映射
开发中动态加插件路径的实操方式
避免每次装插件都跑一遍 composer dump-autoload，可在入口或服务启动时用 ClassLoader::addPsr4() 注入：
$loader = require __DIR__ . '/vendor/autoload.php';
$loader->addPsr4('Acme\Widget\', __DIR__ . '/plugins/widget/src/');
-
addPsr4()第二个参数必须是绝对路径，相对路径不会自动解析 - 该方式绕过 composer.json，适合 CLI 工具、测试桩或热插拔场景
- 注意：若已启用
--classmap-authoritative，动态添加的 PSR-4 路径会被忽略——权威模式下只查 classmap 表 - 多个插件路径可重复调用
addPsr4()，顺序影响优先级，先注册的先匹配
常见错误：类存在却报 Class not found
90% 的问题出在 autoload 配置未生效或路径错位，而不是插件本身有问题。
- 检查是否漏掉
require vendor/autoload.php—— 没这行，所有 autoload 都无效 - 运行
composer show -s确认插件的 PSR-4 规则是否出现在输出中，顺序是否合理 - 插件目录里有
src/，但composer.json写成了"Acme\Widget\": "src"（缺末尾斜杠）→ 导致路径拼错 - 插件用了 classmap 加载，但主项目没运行
composer dump-autoload -o，autoload_classmap.php里根本没它 - Windows 下路径混用
和/，尤其在addPsr4()的绝对路径参数中，应统一用/
真正“自动”的只有 PSR-4 的路径推导逻辑；其余所有映射生成、插件发现、性能优化，都依赖你主动配置、手动触发、仔细验证——没有后台线程，也没有魔法监听。
