Composer 不提供按顺序控制自动加载优先级的机制，files 总在最前因硬编码；项目 PSR-4 默认优先于 vendor；可通过 prependPsr4() 动态调整，files 顺序需用单入口文件显式控制。
Composer 默认不提供“按顺序控制自动加载文件优先级”的机制——autoload 配置本质是注册 PSR-4/PSR-0/classmap/files 映射，最终由 PHP 的 spl_autoload_register() 逐个调用加载器；真正影响“谁先被加载”的，是 vendor/autoload.php 中加载器的注册顺序，以及你手动引入 files 的时机。
为什么 files 加载项总在最前？
因为 Composer 在生成 vendor/autoload.php 时，会把 "files" 类型的脚本放在所有 PSR-4/PSR-0/classmap 加载器之前执行。这是硬编码行为（见 Composer/Autoload/AutoloadGenerator.php），目的是确保全局函数、常量或辅助类在其他类加载前就绪。
实操建议：
- 只把真正需要“提前定义”的内容放进
"files"，比如src/functions.php中的全局函数 - 避免在
files中 require 其他类文件——它不是“类加载入口”，而是“前置环境准备” - 若误把类定义塞进
files，又同时用 PSR-4 加载同名类，将触发Fatal error: Cannot declare class X, because the name is already in use
如何让自己的 PSR-4 命名空间优先于 vendor 包？
不能靠修改 composer.json 里的顺序实现。PSR-4 加载器本身是“按需触发”的，但一旦多个加载器都能解析同一个类名（例如都匹配 App\Foo 和 Vendor\Package\Foo），谁先注册谁先响应——而 Composer 总是把项目根目录的 PSR-4（即你的 "psr-4": {"App\\": "src/"}）注册在 vendor 包之前。
验证方式：查看生成的 vendor/composer/autoload_psr4.php，你会发现你的命名空间映射排在最前面。
注意陷阱：
- 如果你用
composer install --no-dev或切换了COMPOSER_HOME，可能加载的是缓存生成的 autoload 文件，导致本地修改未生效 - 运行
composer dump-autoload -o会合并 classmap，此时 PSR-4 顺序不再起作用——classmap 是查表直取，不走遍历逻辑 - 不要试图用
prepend:true（该选项仅对repositories有效，对 autoload 无效）
想动态调整加载顺序？只能手动干预 autoloader 注册
Composer 生成的 vendor/autoload.php 返回一个 ClassLoader 实例。你可以拿到它，用 addPsr4() / prependPsr4() / addClassMap() 等方法插入新规则，并控制其位置。
示例：强制让 Legacy\ 命名空间在所有 PSR-4 规则最前响应
require __DIR__.'/vendor/autoload.php';
$loader = require __DIR__.'/vendor/autoload.php';
$loader->prependPsr4('Legacy\\', __DIR__.'/legacy/');
// 此时 new Legacy\SomeClass() 会优先从 legacy/ 下加载
// 即使 vendor 包里也有 Legacy\SomeClass，也不会被触发
关键点：
-
prependPsr4()插入到内部$prefixesPsr4数组开头，比默认项目 PSR-4 还早 -
addPsr4()是追加到末尾，通常用于补充 vendor 不覆盖的命名空间 - 所有手动添加的操作必须在
require 'vendor/autoload.php'之后立即进行，否则已有类已被加载，再改无意义
files 顺序无法自定义，但可以绕过
Composer 对 "files" 的加载是静态写死的，无法通过配置调整先后。如果你有多个 files 脚本且依赖顺序敏感（如 A.php 定义常量，B.php 依赖它），唯一可靠做法是：只在 composer.json 中声明一个入口文件（如 src/bootstrap.php），再由它按需 require 其他文件。
错误写法（顺序不可控）：
"autoload": {
"files": ["src/a.php", "src/b.php"]
}
正确写法（显式控制）：
"autoload": {
"files": ["src/bootstrap.php"]
}
src/bootstrap.php 内容：
这种做法也便于调试——直接运行
php src/bootstrap.php就能验证前置逻辑是否正常，不用启动整个 autoloader。真正难处理的从来不是“怎么写配置”，而是当 classmap + PSR-4 + files + 手动 prepend 混用时，哪段代码在哪个时刻定义了哪个符号。遇到类冲突或函数重复定义，第一反应不该是调换
composer.json顺序，而是用get_included_files()或 xdebug 的debug_print_backtrace()查清实际加载链路。
