--classmap-authoritative 能提升 autoloader 性能，因为它强制 Composer 完全跳过 PSR-4/PSR-0 文件系统扫描，仅依赖静态 classmap 查找类；启用需满足所有类均已入 map，且须配合 --optimize-autoloader，不适用于动态生成类或手动 require 未声明类的场景。
为什么 --classmap-authoritative 能提升 autoloader 性能
它强制 Composer 完全跳过 PSR-4/PSR-0 的文件系统扫描，只依赖生成的 classmap 查找类。这意味着每次 new Foo() 或 class_exists('Bar') 时，PHP 不再需要遍历 vendor/autoload_psr4.php 中的路径前缀、拼接文件名、再调用 file_exists() 检查——所有类位置已在 vendor/composer/autoload_classmap.php 中静态映射好。
--classmap-authoritative 的启用条件与副作用
该参数仅在 composer install 或 composer update 时生效，且要求项目中所有类都已被收录进 classmap（即不能存在“未声明但实际存在的类文件”）。常见踩坑点：
- 启用了
--classmap-authoritative，但某包通过files加载的函数文件里动态require了未声明的类 —— 运行时报Class not found - 开发中新增了类但没重新运行
composer dump-autoload（带该 flag）—— 类不可见 -
autoload-dev中的测试类默认不进 classmap，除非显式加到autoload.classmap或使用--optimize-autoloader --classmap-authoritative并确保 dev 类也被扫描
生产环境推荐的完整命令组合
单独用 --classmap-authoritative 效果有限，必须配合 --optimize-autoloader（简称 -o）才能生成完整 classmap。典型部署命令：
composer install --no-dev --optimize-autoloader --classmap-authoritative
注意：--no-dev 必须前置，否则 dev autoload 规则仍可能被加载并干扰权威性；--optimize-autoloader 是生成 classmap 的前提，没有它，--classmap-authoritative 实际无作用。
它不适合哪些场景
以下情况不应启用：
- 使用了插件或脚本在运行时动态生成类（如 Doctrine Proxy、Laravel Octane 的热重载）
- 项目依赖某些通过
include/require手动加载的“非标准类文件”，且未在autoload.classmap中声明路径 - CI/CD 流程中未清理旧
vendor/就直接运行 install —— 可能残留旧 classmap 导致类找不到
classmap 的权威性是把双刃剑：快，但彻底放弃灵活性。一旦启用，就等于告诉 autoloader：“你别猜了，就按这张表找”。表错了，就真找不到了。
