composer dump-autoload -o 没提速，因为它不扫描新文件，仅扁平化 composer.json 中已声明且真实存在的 psr-4/classmap 路径；若未配置或路径错误（如"src"缺"/"），生成的 autoload_classmap.php 就为空或极稀疏。
composer dump-autoload -o 为什么没提速？
因为 composer dump-autoload -o 本身不扫描任何新文件，它只把 composer.json 中已声明的 psr-4 或 classmap 路径“扁平化”写入 vendor/composer/autoload_classmap.php。如果这些路径压根没配，或者配了但路径不存在（比如写成 "src" 而不是 "src/"），生成的 classmap 就是空的或只有几十行。
常见错误现象：
-
vendor/composer/autoload_classmap.php文件体积很小（return []; - 运行
composer dump-autoload -o后，new App\Http\Controller\HomeController()仍触发大量file_exists()调用（可用 Xdebug profile 验证）
真正生效的前提是：你在 composer.json 的 autoload 块里明确写了 "classmap": ["src/", "app/Exceptions/"] —— 注意路径末尾必须带 / 表示递归扫描，且路径必须真实存在。
怎么让 classmap 覆盖全部生产类？
别指望自动发现；得主动收拢、显式声明。PSR-4 是运行时查目录，classmap 是构建时快照，二者不自动同步。
实操建议：
- 把所有实际参与运行的类路径，统一列进
autoload.classmap数组，例如："classmap": ["src/", "app/Providers/", "database/factories/"] - 避免宽泛映射（如
"": "src/"），否则会把src/docs/、src/tests/等无用目录也扫进去，徒增 classmap 体积和构建时间 - 新增类文件后，必须重跑
composer dump-autoload --optimize --classmap-authoritative，classmap 不会自动感知变更 - 确认路径权限正常，符号链接能被
realpath()解析，否则扫描会跳过该目录
exclude-from-classmap 到底排除什么？
它只在生成 classmap 时跳过指定路径，不影响 PSR-4 加载逻辑。也就是说：它删的是 autoload_classmap.php 里的条目，不是阻止文件被加载。
典型使用场景：
- 项目根目录下有
docs/、scripts/、.github/等含 PHP 文件但不参与运行的目录 -
tests/目录没写进autoload-dev，但里面有些工具类被误扫进 classmap
配置要点：
- 字段必须放在
autoload或autoload-dev下，值为字符串数组，如："exclude-from-classmap": ["docs/", "scripts/", "tests/ExampleTest.php"] - 路径相对于项目根目录，不支持
../或绝对路径 - 通配符
*只匹配单层，如"docs/*"不会递归进docs/api/v1/ - 修改后必须运行
composer dump-autoload -o才生效
--classmap-authoritative 模式翻车的常见原因
启用后，自动加载器彻底丢弃 PSR-4 fallback，只查 autoload_classmap.php。一旦漏掉某个类路径，就直接 Class not found。
最容易忽略的点：
- 没加
--no-dev：dev 依赖的类（如测试工具、phpunit 扩展）不会进 classmap，但它们可能被某些服务提供者间接引用，导致 fallback 触发，权威模式失效 - PSR-4 映射路径下存在空子目录（如
src/Commands/下没有 PHP 文件），-o可能漏掉整个命名空间前缀的映射 - 用了
files类型加载（如"files": ["src/helpers.php"]），这类文件不会被 classmap 覆盖，但--classmap-authoritative不影响它 - CI/CD 构建时只跑
composer dump-autoload -o，但没执行composer install --no-dev --optimize-autoloader --classmap-authoritative，新引入的包类根本不在 classmap 里
验证是否真正生效：打开 vendor/composer/autoload_real.php，搜索 findFile 方法——如果只剩 if ($classMap = $this->classMap) 分支，且找不到 $this->prefixesPsr4 相关循环，才算成功。
