classmap-authoritative能加速是因为跳过PSR-4/PSR-0的file_exists()调用，仅查O(1)的autoload_classmap.php数组；但它仅在类全部静态、配置完整且无运行时生成类时才真正生效，否则因缺失fallback机制直接报错。
classmap-authoritative 为什么能加速，但不是总有效
它能跳过所有 PSR-4/PSR-0 的 file_exists() 调用，直接查 autoload_classmap.php 里的数组——O(1) 查找，比拼路径+磁盘 I/O 快得多。但它只在类全部静态、无运行时生成、且配置完整时才真正生效。
常见误判是：跑了 composer dump-autoload -o 就以为提速了，结果 strace 里还在大量 openat(".../Controller.php")。原因很直接：-o 只优化已有规则，没配 classmap 或 psr-4，它就真没东西可优化。
- 项目有 Laravel 的
php artisan ide-helper:generate产出的_ide_helper.php？它不会进 classmap，必须手动加到autoload.files - 用了 Doctrine Proxy 或 Symfony Cache Warmup 生成的类？这些属于运行时类，
--classmap-authoritative下直接报错 -
composer.json里"autoload"段完全空着？那-o和--classmap-authoritative都白加
怎么写 composer.json 的 classmap 才不漏类
classmap 是硬映射，不解析命名空间，只认文件路径和类名字符串。路径必须真实存在、相对项目根目录、末尾带 / 表示递归扫描。
典型错误："classmap": ["src"]（缺斜杠）会被当作文本读，触发 Could not scan for classes warning；"classmap": ["/var/www/app/src/"]（绝对路径）直接被忽略。
- 支持单文件：
"lib/Utils.php"，也支持 glob："legacy/DB_*.php"，但不支持"legacy/*"或"**" - Windows 下统一用
/分隔符，Composer 内部会自动适配 - 多个路径重复扫描同名类？后扫到的覆盖前一个（PHP 数组键唯一），但完整类名含反斜杠，所以
App\User和Legacy\User不冲突 - 别把
tests/、examples/塞进去——它们会被扫进主 classmap，上线后可能意外加载测试逻辑
dump-autoload 命令必须带哪几个参数
单独 composer dump-autoload -o 不等于启用 classmap 加速。真正起效的最小组合是：composer dump-autoload --optimize --classmap-authoritative --no-dev。
--optimize（即 -o）负责扫描并填充 autoload_classmap.php；--classmap-authoritative 强制关闭 fallback，让 autoloader 只信这张表；--no-dev 防止 autoload-dev 下的测试类混入生产映射表。
-
--classmap-authoritative单独用无效，必须搭配--optimize，否则autoload_classmap.php还是空的 - Dockerfile 里写
RUN composer install --classmap-authoritative是错的——install默认不重建 autoload，得加--optimize-autoloader - CI/CD 推荐一步到位：
composer install --no-dev --optimize-autoloader --classmap-authoritative - 验证是否生效：检查
vendor/composer/autoload_classmap.php文件大小（几百 KB 起步），再搜你某个已知类名确认路径存在
为什么开了 authoritative 还报 Class not found
这不是 Composer bug，是它在严格执行“查不到就真没有”。报错意味着这个类根本没进 classmap，或者类名/路径不匹配。
最常踩的坑是大小写和命名空间分隔符：classmap 里存的是声明的原始类名，比如 class stringhelper 对应键是 'stringhelper'，而 new StringHelper() 就找不到。
- 新增类后没重跑
dump-autoload？classmap 不自动更新，旧表里当然没有 - 类文件放在
app/utils/Helper.php，但composer.json只写了"app/"（没斜杠）或漏了"app/utils/"？扫描直接跳过 - 用了
"files"类型加载（如全局函数文件）？它不进 classmap，也不受--classmap-authoritative影响，得单独保留 - 某些框架（如 Laravel）启动时 patch 了
ClassLoader，调用了addPsr4()动态注册——这会让 authoritative 退化
复杂点在于：classmap 生效后，class_exists('SomeClass', false) 返回 true，但 class_exists('SomeClass')（第二个参数默认 true）仍可能触发 fallback——如果 autoloader 被改写过，这点容易被忽略。
