启用 --classmap-authoritative 后，Composer 令自动加载器仅依赖生成的 classmap 映射类名与路径，不再 fallback 到 PSR-4/PSR-0 动态推测；未收录类直接报错，不扫描文件。
这个选项适合在生产环境部署时启用，用来提升自动加载性能并避免运行时扫描文件。
它到底做了什么
启用 --classmap-authoritative 后，Composer 会告诉自动加载器：类名和文件路径的映射关系完全以生成的 classmap 为准，不再尝试用 PSR-4/PSR-0 规则动态推测路径。也就是说，如果一个类没被收录进 classmap，自动加载器就直接报错（Class not found），而不会 fallback 到目录扫描。
什么时候该用
- 应用已稳定，不再频繁增删类文件，比如上线后的 Web 服务或 CLI 工具
- 你明确运行过
composer dump-autoload --classmap-authoritative或安装时加了该参数 - 项目里混用了 classmap 和 PSR-4，且想避免因文件位置变动导致的加载歧义
- 你观察到 autoloader 的文件系统调用较多（比如 strace 或 xdebug profiler 显示大量 stat()），想减少磁盘 I/O
什么时候不该用
- 开发阶段频繁修改类、新增文件，又不想每次改完都手动重生成 autoload
- 项目依赖了某些“动态生成类”的库（如 Doctrine Proxy、PHP-DI 编译缓存），它们可能在运行时写入新类文件
- 使用了未声明在 composer.json 中的“约定式”类（比如某些测试工具按固定规则找 Test 类但没注册 autoload）
- CI/CD 流程中没有确保 classmap 始终最新（例如只 copy vendor 而不重新 dump-autoload）
一个小提醒
它必须配合 classmap 生成才有效——单独加这个参数但没开启 classmap（比如没设 "classmap": ["src/"] 或没跑 dump-autoload -o），效果等同于没开。推荐搭配 composer install --optimize-autoloader --classmap-authoritative 一起用。
基本上就这些。不复杂但容易忽略细节。
