classloader::addpsr4() 不能热插拔生效，根本原因是 spl_autoload_register() 回调绑定后不再感知 $prefixespsr4 数组变化，需先 unregister 再重新 register 才能生效。
ClassLoader::addPsr4() 为什么不能热插拔生效
直接调用 ClassLoader::addPsr4() 添加新命名空间后，后续 new 实例或 class_exists() 仍失败，根本原因不是函数没执行，而是 Composer 的自动加载器已进入“已注册”状态——ClassLoader 内部的 $prefixesPsr4 数组虽被更新，但 PHP 的 spl_autoload_register() 回调函数在首次注册后不会自动感知该数组变化，它只会在每次类未找到时，按原始注册顺序调用已绑定的回调，而那个回调内部只查初始化时快照过的前缀映射。
绕过 autoload_files 重载，手动触发 ClassLoader 重新绑定
Composer 默认把自动加载逻辑固化在 vendor/autoload.php 中，其中核心是 ClassLoader::register()。热插拔的关键不是改映射，而是让 PHP 的 autoloader 机制重新绑定到一个“感知最新映射”的回调。可行做法是：先解注册旧的 autoload 函数，再用修改后的 ClassLoader 实例重新注册。
- 确保你持有原始
ClassLoader实例（通常可通过require 'vendor/autoload.php'后的ComposerAutoloaderInit类静态属性获取，或更稳妥地——在 require 前用$loader = require 'vendor/autoload.php'显式捕获） - 调用
$loader->addPsr4('MyPlugin\', __DIR__ . '/plugins/my-plugin/src/')更新映射 - 执行
spl_autoload_unregister([$loader, 'loadClass'])解除旧绑定 - 再执行
spl_autoload_register([$loader, 'loadClass'], true, true)以 prepend 模式重新注册（第二个true表示 prepend，优先级最高）
插件目录变更后 reload 失败的常见陷阱
即使重新注册了 autoload 回调，仍可能遇到“类找不到”，这往往不是 autoload 逻辑问题，而是 opcache 或 realpath 缓存干扰：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
opcache.enable=1时，PHP 可能缓存了文件不存在的判定结果，需调用opcache_invalidate($file, true)或临时禁用 opcache（开发环境可设opcache.revalidate_freq=0） -
realpath()在底层被大量缓存，若插件目录是符号链接，且你先访问过旧路径，PHP 可能仍返回旧真实路径；建议在addPsr4()前显式调用clearstatcache(true) - 注意
ClassLoader::loadClass()内部会检查$classMap，如果该类曾被 classmap 方式预加载过（比如composer dump-autoload -o），它会跳过 PSR-4 查找——热插拔场景务必避免使用优化 classmap
生产环境慎用：ClassLoader 状态不可预测的边界情况
多个扩展、框架或测试工具（如 PHPUnit）可能各自操作同一个 ClassLoader 实例，或注册自己的 autoload 回调。此时手动 spl_autoload_unregister 可能误删他人回调，导致后续类加载完全中断。更安全的做法是：不复用全局 $loader，而是 new 一个独立 ClassLoader 实例专用于插件，再通过 spl_autoload_register() 单独注册它，并控制其优先级与生命周期。
真正麻烦的从来不是加一行 addPsr4()，而是你不知道当前进程里还有谁在悄悄改 $prefixesPsr4，或者已经把某个类名硬塞进了 $classMap。
