prepend-autoloader 不生效的根本原因是 php 自动加载按 spl_autoload_register 注册顺序触发，若框架提前注册了 loader，composer 的 loader 就无法优先加载；正确做法是确保 vendor/autoload.php 最先引入、autoload-dev 中用 psr-4 精确映射命名空间路径，并避免手动 require 原始类文件。
启用 prepend-autoloader 后，Composer 会把 vendor/autoload.php 中的自动加载逻辑“插到最前面”，从而让 composer.json 里定义的 autoload-dev 或 autoload（尤其是 psr-4 / classmap）优先于项目根目录下同名类文件被加载——但前提是这些类没被其他 autoloader 先注册过。
为什么 prepend-autoloader 不生效？
常见现象：composer dump-autoload --prepend 执行了，vendor/autoload.php 也确实提前引入了，但项目里写的 AppHttpControllerUserController 还是被 app/Http/Controller/UserController.php 覆盖，而不是走你放在 autoload-dev 里的 mock 类。
根本原因：PHP 的自动加载是「按注册顺序触发」的。如果框架（比如 Laravel）在你 require vendor/autoload.php 之前，就已经用 spl_autoload_register() 注册了自己的 loader，那它的逻辑就会先跑，直接找到并加载项目路径下的类，后续 loader 根本没机会触发。
- 检查入口文件（如
public/index.php）是否在require __DIR__.'/../vendor/autoload.php';之前调用了框架初始化代码 - Laravel 9+ 默认已将 autoload 加载提到最前，但某些自定义 bootstrap 流程可能绕过了它
-
prepend-autoloader只影响vendor/autoload.php内部 loader 的注册顺序，不改变外部已注册 loader 的优先级
怎么正确配置 composer.json 实现类覆盖？
核心不是只开 prepend-autoloader，而是确保你要覆盖的类能被 Composer 的 autoloader「先看到」。典型做法是把测试替身或桩类放进 autoload-dev，并用 psr-4 显式声明命名空间映射：
{
"autoload-dev": {
"psr-4": {
"App\": "tests/mocks/app/",
"App\Http\Controller\": "tests/mocks/app/Http/Controller/"
}
},
"config": {
"prepend-autoloader": true
}
}
- 路径
tests/mocks/app/下放一个Http/Controller/UserController.php，namespace 必须严格匹配AppHttpController - 运行
composer dump-autoload --dev --optimize（--dev确保加载autoload-dev配置） - 不要依赖
classmap做覆盖：它不支持命名空间解析，容易漏掉子类或接口实现
运行时 require 顺序决定一切
即使配置全对，如果代码里手动 require 或 include 了原始类文件，或者用了 eval()、__autoload（已废弃）等非标准方式加载，prepend-autoloader 完全无效。
- 确认所有入口都只通过
require 'vendor/autoload.php'启动自动加载，且这是第一个 autoloader 相关操作 - 避免在
bootstrap/app.php或类似文件中提前require_once 'app/Http/Controller/UserController.php' - 使用
get_included_files()或 xdebug 的trace查看实际加载顺序，比猜更可靠
真正起作用的从来不是那个 config 开关，而是 loader 注册时机 + 命名空间路径映射 + 没有更早的手动加载干扰。三者缺一不可。
