必须在 pre-autoload-dump 事件中修改 autoload 配置，因该阶段配置被读取并缓存；post-autoload-dump 时文件已写入磁盘，修改无效；需克隆 package 对象、严格按 schema 设置 psr-4 映射、确保路径真实存在且可读。
不能劫持 autoload 加载流程本身，但可以在 autoloader 生成阶段干预映射内容 —— 关键是 pre-autoload-dump 事件，不是 post-autoload-dump。
为什么 post-autoload-dump 拿不到你新增的 classmap
因为 post-autoload-dump 触发时，vendor/autoload.php 和所有 autoload_*.php 文件已经写入磁盘。此时再修改 $composer->getPackage()->getAutoload()，对本次 dump 完全无效。
- 现象：你在
post-autoload-dump里调用$event->getComposer()->getPackage()->setAutoload(...)，但新路径没进autoload_psr4.php - 根本原因：autoloader 配置在
pre-autoload-dump阶段已被读取并缓存，后续修改不参与本次生成 - 正确时机必须是
pre-autoload-dump，且要确保新增路径物理存在（否则 Composer 会跳过扫描）
如何在 pre-autoload-dump 中安全注入 PSR-4 映射
插件的 activate() 方法里注册监听器，回调中直接修改 root package 的 autoload 配置数组，然后调用 $event->setPackage($modifiedPackage) 提交变更。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 不要直接改
$event->getComposer()->getPackage()返回的对象 —— 它是只读副本，改了也不生效 - 正确做法：用
$package = clone $event->getComposer()->getPackage()，再调用$package->setAutoload($newAutoloadArray) -
$newAutoloadArray格式必须严格匹配 composer.json schema：["psr-4" => ["MyPlugin\Extra" => "/path/to/extra/src"]]，末尾反斜杠不能漏 - 路径必须绝对且可读：
/path/to/extra/src要真实存在，且 Composer 进程有权限遍历
files 类型函数文件能被插件动态注入吗
不能。Composer 的 files 加载是在 autoload_real.php 中硬编码 require 的，插件无法在运行时插入新 files 条目 —— 因为 files 列表在 dump-autoload 时已固化进 autoload_files.php，且不支持事件钩子动态扩展。
- 替代方案：在
pre-autoload-dump中把你的函数文件路径加进psr-4或classmap（需确保该文件定义了一个类，哪怕空类），再通过require_once手动加载 - 更稳妥的做法：让使用者显式配置
"files": ["vendor/your-plugin/functions.php"]，插件只负责生成该文件 - 注意：插件自身
autoload里的files只影响插件内部，不影响宿主项目
常见失效场景：autoload 修改后 vendor/composer/autoload_psr4.php 没更新
不是插件没运行，而是 Composer 缓存了旧的 autoload 映射 —— dump-autoload 不会自动重读插件修改，它只读 composer.json 和已安装包的 autoload 声明。
- 必须手动触发：执行
composer dump-autoload（或composer install --no-scripts后再dump-autoload） - 检查点：确认
vendor/composer/autoload_psr4.php文件里是否出现你注入的 namespace → path 映射 - 调试技巧：在插件
pre-autoload-dump回调里file_put_contents('/tmp/debug.log', print_r($newAutoloadArray, true), FILE_APPEND)，验证是否真被调用 - 最容易忽略的一点：插件修改 autoload 后，如果宿主项目启用了
"optimize-autoloader": true，必须加--optimize参数重新 dump，否则 classmap 模式下 PSR-4 条目可能被跳过
