psr-4 不支持同一命名空间映射多个目录，composer 仅取最后一个路径；应改用 psr-4 + classmap 混合策略，并将测试类放入 autoload-dev 以避免生产环境加载风险。
psr-4 不能直接映射一个命名空间到多个目录
Composer 的 psr-4 配置不支持为同一个命名空间声明多个目录路径。如果你在 composer.json 里写成：
"autoload": {
"psr-4": {
"App\": ["src/", "tests/Support/"]
}
}
这会报错或被忽略第二项——Composer 只取最后一个有效值，不会合并。
根本原因是 PSR-4 规范本身要求「一个命名空间前缀 → 唯一根路径」，Composer 严格遵循该语义，不提供路径拼接逻辑。
用 classmap + psr-4 混合 autoload 替代多目录映射
真实项目中要让 App\ 下的类既能从 src/ 加载，又能从 tests/Support/ 加载，得绕开纯 psr-4，改用混合策略：
-
psr-4覆盖主代码路径（如"App\": "src/"） -
classmap显式登记额外路径里的类文件（如"tests/Support/"） - 运行
composer dump-autoload生效
示例配置：
"autoload": {
"psr-4": {
"App\": "src/"
},
"classmap": [
"tests/Support/"
]
}
注意：classmap 扫描的是具体 PHP 文件，不是命名空间；它生成静态映射表，所以新增类后必须重新 dump。
测试目录混入 autoload 的风险点
把 tests/Support/ 加进 autoload 容易踩三个坑：
- 生产环境也会加载测试辅助类，可能暴露非预期行为或增加内存占用
- 如果测试类和 src 类同名（比如都叫
App\TestCase），classmap 和 psr-4 冲突会导致加载不可控（通常 classmap 优先） -
composer install --no-dev时，classmap仍会生效——它不区分 dev 或 prod，这点常被忽略
更稳妥的做法是：只在 autoload-dev 里配 classmap，确保仅开发时加载：
"autoload-dev": {
"classmap": ["tests/Support/"]
}
想动态切换路径？别碰 autoload，改用服务容器或手动 require
如果需求本质是「运行时按条件加载不同实现」，比如测试时用 Mock 类、线上用真实类，那 autoload 不是解法：
- autoload 是静态注册机制，不是运行时路由
- 强行塞一堆路径会让自动补全、静态分析（PHPStan/IDE）混乱
- 推荐做法：用依赖注入容器绑定接口实现，或在代码里用
file_exists()+require_once()按需加载
例如：
if (defined('PHPUNIT_TESTSUITE')) {
require_once __DIR__.'/tests/Support/MyServiceStub.php';
} else {
require_once __DIR__.'/src/MyService.php';
}
这种控制粒度更细，也更容易被 IDE 和 linter 理解。
真正麻烦的从来不是怎么写进 composer.json，而是没想清楚：这个“多目录”需求，到底是要解决加载问题，还是隔离问题，或是替换问题——搞错目标，配置再花哨也没用。
