Composer 中需按类型（psr-4/classmap/files）分别配置多个 autoload 路径：psr-4 用命名空间前缀映射目录，classmap 扫描目录或文件列表，files 列出全局加载的 PHP 文件；顺序无关，但前缀须互斥，路径须规范。
composer.json 里怎么写多个 autoload paths？
Composer 支持在 autoload 下配置多个路径，但不是简单地“堆叠”目录——必须明确指定类型（psr-4、psr-0、classmap 或 files），每种类型内部才能定义多个映射。直接写一堆路径到一个字段会报错或被忽略。
常见错误现象：composer dump-autoload 后类仍找不到，或者 Class not found 错误没变；根本原因是路径没按规范嵌套进对应 autoload 类型下。
-
psr-4最常用：每个子项是"命名空间前缀" => "物理路径"，路径可写多个，互不干扰 -
classmap适合非标准结构的旧代码：值是路径数组，支持目录或具体文件 -
files用于全局加载（如函数库）：值是.php文件路径数组，每次请求都 require
示例（合法）：
{
"autoload": {
"psr-4": {
"App\": "src/",
"Tests\": "tests/"
},
"classmap": ["legacy/", "lib/Helper.php"],
"files": ["src/functions.php", "src/helpers/str.php"]
}
}
psr-4 多路径冲突时谁生效？
PSR-4 不是“按顺序匹配”，而是“精确前缀最长匹配”。Composer 会把所有 psr-4 映射缓存成前缀树，自动选最具体的那个路径。所以顺序无关紧要，但前缀不能重叠且无歧义。
容易踩的坑："App" => "src/" 和 "AppController" => "old-controllers/" 看似合理，实际会导致 AppControllerFoo 既可能去 src/Controller/Foo.php，也可能去 old-controllers/Foo.php，取决于你是否在 src/ 下真有 Controller/ 目录——Composer 不校验目录是否存在，只按规则拼路径。
- 确保命名空间前缀互斥，比如用
OldApp\替代App\Controller\ - 运行
composer dump-autoload -o后检查vendor/composer/autoload_psr4.php，确认生成的映射符合预期 - 如果想强制走某路径，优先用
classmap显式登记具体文件，它比 PSR-4 优先级高
为什么 vendor 里的包没被我的 autoload 覆盖？
你的 composer.json 中的 autoload 只影响你项目根命名空间下的类加载，不影响 vendor/ 中已安装包的自动加载逻辑。那些包各自的 autoload 配置由 Composer 在安装时合并进全局映射表，彼此隔离。
使用场景：你想在开发中临时用本地代码替代 vendor 包里的某个类（比如调试），不能靠改自己项目的 autoload 实现。
- 正确做法是用
repositories+path类型覆盖包，或用autoload-dev加载测试替身 -
autoload-dev下的路径不会打进生产 autoloader，适合放 Mock 类或集成测试辅助代码 - 切勿在
autoload里写指向vendor/子目录的路径——Composer 会跳过，且下次dump-autoload可能清掉缓存导致更混乱
classmap 和 files 的性能与更新陷阱
classmap 是一次性扫描生成静态列表，速度快但不感知文件增删；files 是每次请求都 require，零延迟但无法热更新——改了文件得重新 dump-autoload 才生效。
性能影响明显：100 个 files 项 = 每次请求多 require 100 个文件；而 classmap 扫描大目录（如含数千文件）会让 dump-autoload 变慢数秒。
-
classmap路径建议精简，避免扫node_modules或.git目录（可用exclude-from-classmap过滤） -
files只放真正需要全局可用的函数文件，别塞配置或模板 - CI 环境中若用
composer install --no-autoloader，后续必须显式跑dump-autoload，否则files和classmap都不生效
autoload 的灵活性背后是映射规则的刚性——路径写错一个斜杠、命名空间少一个反斜杠、JSON 多了个逗号，都会让整块失效，而且错误提示往往藏在 vendor 缓存深处，不容易一眼定位。
