深层目录结构使psr-4加载变慢因需多层目录遍历和多次stat()调用；dump-autoload -o仅在显式配置"classmap"且配合-a或--classmap-authoritative时才真正覆盖并加速深层类加载。
为什么深层目录结构会让 PSR-4 自动加载变慢
PSR-4 的路径解析依赖 realpath() + 字符串拼接 + 文件系统 stat 调用。当类名是 App\Infrastructure\Repositories\Eloquent\Users\UserRepository，对应路径变成 src/Infrastructure/Repositories/Eloquent/Users/UserRepository.php，中间要经过 6 层目录遍历和至少 2 次 stat()（检查目录是否存在、检查文件是否存在）。PHP 每次 require 类时都得走一遍，opcache 缓存的是脚本内容，不是路径查找过程。
dump-autoload -o 对深层目录有效吗
只在满足特定条件时才真正提速：
- 项目中显式配置了
"classmap": ["src/"]—— 否则composer dump-autoload -o只是把 PSR-4 映射“硬编码”进autoload_classmap.php，但不会扫描深层目录里的类 - 类文件命名规范：不能有
My_Controller.php这类下划线分隔的文件名（Composer classmap 扫描器会跳过） - 测试目录、私有工具类目录必须手动加进
autoload.classmap，否则不被收录 - 运行
composer dump-autoload -a（-a强制重扫 classmap），而不是仅-o
纯 PSR-4 配置下，-o 不触发深层目录扫描，autoload_classmap.php 里根本不会有 App\Infrastructure\... 这类长命名空间的条目。
怎么让 classmap 覆盖所有深层类
别指望自动发现，必须收口管理：
- 在
composer.json的autoload.classmap中明确列出顶层入口目录："src/"、"app/"、"lib/"，不要写"src/Infrastructure/"这种子目录——classmap 扫描器只递归你给的路径，不推导子路径 - 删掉冗余的 PSR-4 配置项，尤其当整个
src/都按标准结构组织时，全切到 classmap 更省事 - 执行
composer dump-autoload -a，然后立刻检查vendor/composer/autoload_classmap.php是否包含你期望的深层类名，比如搜索UserRepository看路径是否对 - 确认
vendor/composer/autoload_real.php中有$loader->addClassMap($map)调用，没有就说明 classmap 没生效
--classmap-authoritative 是提速关键，也是最大风险点
它让 autoloader 彻底放弃 PSR-4 的 fallback 查找，只查 autoload_classmap.php。对深层目录结构效果最明显——路径拼接和 stat() 全部跳过，O(1) 数组查找。
但容易漏掉的点很隐蔽：
- CI/CD 构建时如果只跑
composer dump-autoload -a --classmap-authoritative，但没执行composer install --no-dev，那 vendor 里新包的 classmap 根本没生成 - Laravel 的
Tests\Feature\*目录默认不在 autoload 配置里，启用后测试直接报Class not found - 某些包（如旧版 phpexcel）依赖
autoload.files，而--classmap-authoritative会忽略这类配置，除非你把它也加进 classmap 扫描路径
真正生效的前提不是加参数，而是 classmap 文件里真有你要的类——而且得确保每次部署都完整重建，不是靠局部刷新。
