Composer中为同一命名空间配置多路径的合规方式有两种：一是PSR-4映射值设为路径数组，如"App\": ["src/", "packages/my-module/src/"]；二是按语义拆分为子命名空间，如"App\": "src/"与"App\Plugin\MyModule\": "packages/my-module/src/"。
在 composer.json 中为同一个命名空间配置多个路径，不能直接写多个 psr-4 条目指向同一命名空间（Composer 会覆盖或报错），但可以通过以下两种合规、实用的方式实现。
方式一：用数组值定义多个源目录（推荐）
PSR-4 支持将某个命名空间映射到一个路径数组，Composer 会按顺序查找类文件。这是最标准、最清晰的做法。
例如，你想让 App\ 命名空间同时从 src/ 和 packages/my-module/src/ 加载：
"autoload": {
"psr-4": {
"App\\": ["src/", "packages/my-module/src/"]
}
}
注意点：
- 路径末尾必须带斜杠（
/），且使用双反斜杠转义命名空间分隔符 - Composer 查找时按数组顺序扫描：先查
src/，找不到再查packages/my-module/src/ - 执行
composer dump-autoload后生效
方式二：拆分为子命名空间 + 独立路径（适合模块化结构）
如果多个路径对应逻辑上不同的功能模块，更推荐按语义拆分命名空间，避免路径耦合。
比如把核心代码和插件代码分开管理：
"autoload": {
"psr-4": {
"App\\": "src/",
"App\\Plugin\\MyModule\\": "packages/my-module/src/"
}
}
这样既保持清晰，又避免运行时路径冲突，也方便后期单独发布包。
好处：
- 类加载路径明确，调试更直观
- 符合 PSR-4 “命名空间前缀 → 路径前缀” 的设计本意
- 便于 IDE 自动补全和静态分析工具识别
不推荐的做法（避坑提醒）
以下写法看似可行，但实际有问题：
-
"App\\": "src/"和"App\\": "packages/my-module/src/"写两条 —— JSON 键重复，后一条会覆盖前一条 - 用 PSR-0 混搭（已废弃，且不支持多路径）
- 手动修改
vendor/composer/autoload_psr4.php—— 下次dump-autoload就被重置
基本上就这些。多路径本质是加载优先级问题，用数组形式声明最直接，拆命名空间则更利于长期维护。
