优先选 psr-4：它自动映射命名空间与路径、IDE 支持好、无需手动更新；classmap 仅适用于无命名空间的零散旧文件，且易因漏执行 dump-autoload 导致 CI 失败。
autoload-dev 中的 psr-4 和 classmap 怎么选？
测试辅助类通常放在 tests/Support 或 tests/Helpers 下，不参与生产代码加载。用 psr-4 最稳妥：它按命名空间自动映射路径，IDE 支持好，且 Composer 自动处理文件变动；classmap 虽能强制加载任意文件，但需手动执行 composer dump-autoload，CI 环境容易漏掉，还可能意外把测试类打进生产 autoloader。
常见错误是把 autoload-dev 写成 autoload，导致测试类被生产环境加载——这会增大内存占用，还可能因依赖未安装（如 phpunit）而报 Class not found 错误。
-
psr-4适合有统一命名空间的辅助类，例如"Tests\Support\\": "tests/Support/" -
classmap仅用于零散、无命名空间的旧式.php文件（极少见） - 别在
autoload-dev里重复定义autoload已声明的路径，Composer 不会合并，而是完全隔离
composer.json 中 autoload-dev 的标准写法
必须严格放在 autoload-dev 键下，与 autoload 并列。命名空间末尾的反斜杠不能省略，否则 PSR-4 解析失败；路径必须以 / 结尾（Windows 下也用正斜杠），否则 Composer 可能忽略。
{
"autoload": {
"psr-4": {
"App\\": "src/"
}
},
"autoload-dev": {
"psr-4": {
"Tests\\Support\\": "tests/Support/",
"Tests\\Feature\\": "tests/Feature/",
"Tests\\Unit\\": "tests/Unit/"
}
}
}
执行 composer dump-autoload 后，vendor/autoload.php 会同时加载 autoload 和 autoload-dev 的规则，但仅当该文件被引入时才生效（例如 PHPUnit 启动时自动 require 它）。
为什么 PHPUnit 运行时找不到我的 Helper 类？
最常见原因是命名空间与文件路径不匹配。比如文件 tests/Support/DatabaseHelper.php 声明了 namespace Tests\Helpers;，但 autoload-dev 里写的是 "Tests\\Support\\": "tests/Support/" —— 此时命名空间和目录名不一致，Composer 根本不会扫描这个文件。
- 检查
namespace声明是否与autoload-dev中的键完全对应（包括大小写） - 确认文件实际路径是否真在指定目录下，Composer 不递归扫描子目录
- 运行
composer show --platform验证 autoloader 是否已注册；或临时加一行var_dump(class_exists('Tests\Support\DatabaseHelper'));在测试中调试 - 如果用了符号链接，确保
composer dump-autoload -o（优化模式）未启用，它会跳过 symlink 目录
测试类能否访问 src 下的内部类？
可以，但要注意 visibility。autoload-dev 只控制「加载」，不控制「可见性」。如果 src/Service/InternalProcessor.php 里有个 private function，测试类哪怕成功加载了这个类也无法调用它；此时应改用 protected + setAccessible(true)（PHP 8.1+ 推荐用 ReflectionMethod::invoke() 替代）。
另一个易忽略点：某些辅助类依赖 phpunit/phpunit 中的类（如 PHPUnit\Framework\TestCase），若在 autoload-dev 中提前加载了这些类，而当前环境未安装 PHPUnit（如生产部署后运行 composer install --no-dev），就会触发 fatal error。因此，所有只在测试中使用的 use 语句，务必确保其所在文件**只通过测试入口加载**，不要被 autoload 规则意外覆盖。
