默认 prepend-autoloader 为 true，需在 composer.json 的根级 config 段设 "prepend-autoloader": false，并运行 composer dump-autoload 或 install 才生效。
默认情况下，Composer 的 prepend-autoloader 是 true，这意味着它会把自身生成的 autoloader 注入到 PHP 原生 spl_autoload_register() 队列最前面——如果你希望自定义加载器优先执行（比如拦截类名、做运行时代理、兼容旧框架），就必须设为 false。
在哪改：composer.json 的 autoload 配置段不生效
很多人误以为在 autoload 或 autoload-dev 下加字段能控制这个行为——其实不能。prepend-autoloader 是 Composer 安装/更新阶段的行为开关，和自动加载规则本身无关。
- 它只存在于
config段，不是autoload段 - 必须写在根级
config对象里，且只对当前项目生效（不影响依赖包） - 修改后需重新运行
composer dump-autoload或composer install才会重建vendor/autoload.php
怎么设：config.prefer-stable 和 prepend-autoloader 是平级配置项
在 composer.json 中添加或修改 config 块：
{
"config": {
"prepend-autoloader": false
}
}
注意：prepend-autoloader 是布尔值，不要加引号；如果同时用了 fxp/composer-asset-plugin 或某些老旧插件，它们可能强制覆盖该设置，此时要检查插件文档是否支持禁用前置注册。
为什么设 false：避免类加载被“劫持”导致调试困难
当 prepend-autoloader 为 true（默认），Composer 的 autoloader 总是第一个响应 class_exists() 或 new 实例化请求。这会导致：
- 你写的全局
spl_autoload_register(..., true)（true表示 prepend）实际被 Composer 覆盖，根本没机会执行 - 某些测试框架（如 PHPUnit 自带的类重载机制）或 AOP 工具依赖后置加载顺序，否则无法拦截原始类定义
-
vendor/autoload.php被 require 后，再调用spl_autoload_register()添加的加载器，会排在 Composer 之后——这是唯一可靠的方式，但前提是 Composer 不抢占
验证是否生效：看 vendor/autoload.php 最后几行
生成后的 vendor/autoload.php 开头会有类似注释：
// autoload.php @generated by Composer // ... // autoload_real.php @generated by Composer
关键看它最终调用 ComposerAutoloaderInit...::getLoader() 后，有没有紧接着一行 spl_autoload_register(array('ComposerAutoloaderInit...', 'loadClassLoader'), true); —— 如果有，说明仍是 prepend 模式；设为 false 后，这行会变成 false 或直接消失，且你的后续 spl_autoload_register 调用才能真正“后置”。
这个细节很容易被忽略：改了配置却不重生成 autoload 文件，或者没意识到只有 dump-autoload 或完整 install 才会重写该文件。
