prepend-autoloader 设为 true 会使 composer 的 autoloader 通过 spl_autoload_register(..., true) 注册到加载队列最前面，优先响应类加载请求，而非默认追加到末尾；该配置需置于 composer.json 的 config 段并执行 dump-autoload 生效。
为什么 prepend-autoloader 设为 true 会影响类加载顺序
Composer 默认把 vendor/autoload.php 的加载逻辑追加到 PHP 的自动加载队列末尾；设成 true 后，它会用 spl_autoload_register(..., true) 把自己的加载器插到最前面——这意味着你项目里定义的同名类（比如 MyClass）如果同时存在于 src/ 和某个 vendor/ 包里，Composer 会先尝试加载 vendor 里的，**而不是你本地写的那个**。这不是“优先加载 vendor”，而是“让 vendor 的 autoloader 更早响应”。
常见错误现象：Class MyClass is not found 突然出现，或本地重写的类被 vendor 包悄悄覆盖了，调试时发现 get_included_files() 里 vendor/autoload.php 确实排在你自己的 require 'src/Bootstrap.php' 前面。
- 只在
composer.json的autoload或autoload-dev下无效，它属于安装/生成阶段配置 - 必须通过
config段设置："config": { "prepend-autoloader": true } - 该配置仅影响
vendor/autoload.php的注册方式，不影响 PSR-4/PSR-0 映射本身 - PHP 7.4+ 下行为稳定；PHP 5.6–7.3 中某些 SAPI（如 CLI 与 Apache mod_php）表现略有差异，建议统一测试
如何在 composer.json 中正确启用 prepend-autoloader
这个配置不是写在 autoload 里，而是放在顶层 config 字段中。改完后必须重新生成 autoloader（哪怕只是 dump-autoload），否则不生效。
示例片段：
{
"name": "my/app",
"config": {
"prepend-autoloader": true
},
"autoload": {
"psr-4": { "App\": "src/" }
}
}
- 执行
composer dump-autoload或composer install后，vendor/autoload.php顶部会多出一行类似spl_autoload_register(require __DIR__ . '/autoload_real.php', true); - 如果用了
composer install --no-autoloader，这个配置会被跳过 - 团队协作时注意：该配置不会改变已生成的
vendor/autoload.php，必须确保所有成员都运行了重生成命令
prepend-autoloader=true 在哪些场景下真有用
它不是“让 vendor 优先”，而是“让 Composer 的 autoloader 优先”——所以真正受益的是那些依赖「提前接管类加载」的工具或模式。
- 使用
phpunit+--bootstrap且需拦截某些类（比如 mock 全局类）时，前置加载能保证 PHPUnit 的测试 autoloader 先于项目代码注册 - 集成
humbug/php-scoper或roave/better-reflection等反射敏感工具时，避免它们被项目已有 autoloader 干扰 - 旧项目迁移中存在多个手动
spl_autoload_register调用，且你希望 Composer 的规则最先匹配 - 不适用于“想让
src/类覆盖vendor/类”的需求——那应该用 class alias、继承重写，或调整 PSR-4 映射顺序
容易被忽略的兼容性细节
这个配置看似简单，但有几个低频但致命的坑：
- 某些共享主机禁用
spl_autoload_register的$prepend参数（PHP autoload.php 报Warning: spl_autoload_register(): Invalid argument - Laravel 的
app/Providers/AppServiceProvider.php中若在boot()里动态注册 autoloader，可能和前置的 Composer 加载器冲突，导致类找不到 - Docker 构建中如果分层缓存了
vendor/但没缓存composer.json变更，prepend-autoloader改了也白改 - 它对
classmap生成无影响，只改加载器注册时机；如果你靠classmap加载核心类，这个配置几乎不改变行为
最常被漏掉的一点：改了 composer.json 里的 config，却忘了 git add composer.lock ——而 composer.lock 里其实也存了这个配置的快照，CI 环境只读 lock 文件，不读 json。
