prepend-autoloader 设为 true 会使 composer 的 autoloader 通过 spl_autoload_register(…, true) 插入队列最前，确保第三方工具（如 phpunit-bridge）能劫持 require；设为 false 则按默认末尾注册；配置需在 config 下写布尔值，修改后须执行 dump-autoload 或 install 才生效。
默认情况下，prepend-autoloader 设为 true 才能让 Composer 加载的包代码「早于」你项目自己的 autoload 规则执行——但这不是为了“优先加载你的代码”，恰恰相反：它是让第三方库的 autoloader 先注册，从而在某些底层扩展（如 Patchwork、phpunit-bridge）需要劫持 require 时能生效。
为什么 prepend-autoloader 影响加载顺序
Composer 的 autoloader 是通过 PHP 的 spl_autoload_register() 注册的。这个函数默认把新注册器加到队列末尾；而设 "prepend-autoloader": true 后，Composer 会显式用 spl_autoload_register(..., true) 把自己的 loader 插到最前面。
这意味着：
- 若你项目用了
classmap或psr-4自动加载，且依赖某个需提前拦截require的工具（比如symfony/phpunit-bridge的bootstrap.php），那必须prepend-autoloader=true，否则它根本抢不到控制权 - 若你手动写了
require_once 'vendor/autoload.php'，又在它之后定义了同名类，prepend-autoloader=true反而会让 Composer 先抛出Class already declared错误 -
composer install和composer dump-autoload都会读取该配置，但不会自动重写vendor/autoload.php—— 它只影响生成逻辑
怎么在 composer.json 里正确配置
直接在根级写布尔值即可，不需要嵌套或额外字段：
{ "config": { "prepend-autoloader": true } }常见错误操作：
- 写成
"prepend-autoloader": "true"（字符串 → 被当 false） - 放在
autoload或scripts下（无效位置） - 以为设了就能让自己的
psr-4“优先”——其实它只控制 Composer 自身 loader 的注册顺序，不改变你项目内 autoload 规则的匹配逻辑
dump-autoload --optimize 和 prepend-autoloader 的关系
启用 --optimize（即生成 vendor/composer/autoload_classmap.php）时，prepend-autoloader 依然生效，但它影响的是「classmap loader 是否被 prepended」，而不是 classmap 本身的内容顺序。
真正要注意的是：
- 优化后所有类路径都进了一个大数组，不再走 PSR-4 动态解析 —— 所以如果你依赖某些运行时动态生成类名的逻辑（比如 laravel 的匿名迁移类），
--optimize可能导致类找不到，跟prepend-autoloader无关，但常被一起误调 -
prepend-autoloader=false+--optimize在某些 CI 环境下会导致phpunit启动失败（因测试 bootstrap 没抢到 autoloader 控制权）
最易被忽略的一点：这个配置只在 vendor/autoload.php 生成时起作用；改完 composer.json 后必须运行 composer dump-autoload 或 composer install，否则旧文件里的注册顺序不会变。