Composer支持为同一命名空间配置多个路径：①用psr-4数组按序映射多目录，优先查找靠前路径；②可组合psr-4与classmap，后者兜底加载非PSR-4结构类；③files不适用于命名空间路径映射。
在 composer.json 中，一个命名空间不能直接配置多个“备用路径”，但可以通过 多个 autoload 映射规则 实现等效效果——Composer 会按定义顺序依次查找，找到第一个匹配的文件即停止。
使用 psr-4（推荐）配合多个目录映射同一命名空间
PSR-4 允许你为同一个命名空间指定多个源目录，Composer 会按数组顺序逐个尝试。这是最常用、最清晰的方式：
{
"autoload": {
"psr-4": {
"App\\": [
"src/",
"vendor/mycompany/shared/src/",
"stubs/app/"
]
}
}
}
说明：
- Composer 查找
App\Foo\Bar类时，先查src/Foo/Bar.php，不存在则查vendor/mycompany/shared/src/Foo/Bar.php，再不行才查stubs/app/Foo/Bar.php - 所有路径必须是真实存在的目录（运行
composer dump-autoload时会验证） - 路径顺序很重要：靠前的优先级更高，适合把项目主代码放前面，共享/兜底逻辑放后面
混用 psr-4 和 classmap 做兜底补充
当某些类不遵循 PSR-4 结构（比如扁平文件、动态生成类），可用 classmap 补充自动加载：
{
"autoload": {
"psr-4": {
"App\\": "src/"
},
"classmap": [
"legacy/classes/",
"generated/autoloader-stubs.php"
]
}
}
说明：
- PSR-4 规则优先执行；若没找到，Composer 会继续查
classmap生成的映射表 -
classmap是静态扫描结果，需手动运行composer dump-autoload更新 - 适合加载老项目遗留代码或预生成的桩文件
避免用 files 加载整个命名空间
"files" 是用于加载函数文件（如 helpers.php）的，它不支持命名空间路径映射，也不能实现“按命名空间找多个路径”的逻辑：
- ❌ 错误写法：
"files": ["src/", "lib/"]—— 这只会尝试加载这两个路径下的 PHP 文件（不是按命名空间），且不递归 - ✅ 正确思路：想让多个目录参与命名空间加载，只用
psr-4数组或组合psr-4 + classmap
基本上就这些。核心就是：用 psr-4 的数组形式声明多路径，或用 classmap 做结构不规范的补充。不需要额外插件或 hack，Composer 原生支持。
