composer不支持局部类重写，唯一可靠方式是通过prependpsr4()在autoload后、类加载前插入更长前缀的psr-4规则，依赖最长前缀匹配机制实现覆盖。
Composer 不支持“局部类重写”——你不能让 AppServiceUserService 在某些场景下加载自定义版本，而在其他地方走 vendor 包原版，除非你主动干预加载逻辑。所谓“无侵入劫持”，本质是绕过默认 PSR-4 匹配规则，在类被首次请求时，用你自己的路径提前响应。
psr-4 命名空间前缀长度决定谁先加载
当两个 PSR-4 规则都能匹配同一个类名（比如 AppServiceUserService），Composer 会选**最长前缀匹配**的规则，而不是按配置顺序或注册顺序。这是硬编码在 ClassLoader::findFile() 里的行为，不可关闭或绕过。
- 如果你配了
"App\": "src/"和"App\Service\": "override/service/"，那么AppServiceUserService一定走override/service/UserService.php - 但
AppControllerHomeController仍走src/Controller/HomeController.php，因为"App\"是唯一匹配前缀 - 前缀长度相同时（如
"A\": "a/"和"B\": "b/"），才按autoload_psr4.php数组键的声明顺序遍历
prependPsr4() 是唯一可控的运行时插入点
Composer 生成的 vendor/autoload.php 返回一个 ClassLoader 实例，你可以拿到它并调用 prependPsr4() 把你的覆盖规则插到最前面。这比改 composer.json 更灵活，且不依赖 dump-autoload。
- 必须在
require 'vendor/autoload.php'之后、任何类被引用之前执行 - 示例：
$loader = require __DIR__ . '/vendor/autoload.php'; $loader->prependPsr4('App\Service\', __DIR__ . '/override/service/'); - 注意路径末尾不加斜杠，
prependPsr4()内部会自动处理；但命名空间末尾双反斜杠"App\Service\"必须写全，否则 PHP 解析失败 - 这个操作只影响当前进程，CI 或 CLI 脚本里要确保每次启动都执行一遍
files 和 classmap 都不适合做“局部重写”
很多人想用 files 加载一个同名类来覆盖 vendor 类，这会导致 Fatal error: Cannot declare class —— 因为 files 是无条件 require_once，早于所有类加载器执行，而 vendor 的 PSR-4 会在之后再次尝试加载同一类。
-
classmap看似可行，但一旦启用优化模式（composer dump-autoload -o），classmap 就变成静态查表，无法动态切换；且新增类必须重新 dump，不适合开发期热替换 - 把重写类放进
files是典型误用：它不是类加载机制，而是全局脚本注入点，仅适合函数/常量 - 若真要用
classmap做覆盖，必须确保原 vendor 类**完全不被 PSR-4 加载到**——即删掉或注释掉对应包的 autoload 配置，否则仍会冲突
不要碰 prepend-autoloader 配置
"config": {"prepend-autoloader": true} 控制的是 Composer 自身 autoloader 在 PHP spl_autoload_register 队列里的位置，和“哪个类被哪个路径加载”完全无关。设成 true 只会让整个 Composer 加载器抢在你手动写的 spl_autoload_register 前执行，对局部重写没帮助，反而可能让调试更难。
- 它不影响
autoload_psr4.php里各命名空间的匹配优先级 - 试图靠它“让我的重写类先加载”，属于因果倒置：真正起作用的是 PSR-4 前缀长度或
prependPsr4()注入顺序 - 修改后必须
composer dump-autoload才生效，但改了也没用——这不是该字段的设计用途
最易被忽略的一点：PHP 的类定义一旦进入符号表就不可撤销。所谓“重写”，只能发生在类第一次被加载前；一旦 class_exists('AppServiceUserService') 返回 true，后续任何 prepend 或映射调整都无效。所以重写逻辑必须在应用初始化最早期完成，且不能依赖条件判断延迟执行。
