必须同时使用--optimize-autoloader和--classmap-authoritative才能真正禁用fallback查找、消除file_exists()调用；仅加-o无效，因classloader仍会动态扫描路径。
默认的 ClassLoader 在高并发或冷启动时慢，不是因为类多，而是它每次都要拼路径、调 file_exists()、遍历目录——这个开销在 PHP-FPM 下会被放大几十倍。必须用 classmap + --classmap-authoritative 组合才能真正关掉 fallback 查找。
为什么 dump-autoload -o 单独执行没效果
只加 -o（即 --optimize-autoloader）只是把 PSR-4 映射“合并”进 autoload_classmap.php，但 ClassLoader 仍会 fallback 到动态查找逻辑；它不提速，只让 classmap 文件变大。
- 必须同时加
--classmap-authoritative，否则findFile()还会频繁调用 - 该参数在 Composer 2.2+ 中默认仅对生产环境生效（
COMPOSER_DEV_MODE=0或显式传--no-dev） - 检查
vendor/composer/autoload_real.php：若没看到$loader->addClassMap($map)被调用，说明 classmap 根本没加载 - 本地开发误加此参数会导致
php artisan tinker或 PHPUnit Mock 类直接报Class not found
--classmap-authoritative 报错 Class not found 怎么排查
这不是 bug，是它在严格执行“不在 classmap 就不找”。常见漏类原因都和配置或命名规范有关：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 命名空间末尾缺反斜杠，例如
"App": "app/"应为"App\": "app/"，否则扫描器跳过整个目录 - 类文件路径与命名空间不严格对应，比如
namespace AppConsoleCommands;（少），导致DeployCommand不被收录 -
autoload-dev里的路径被扫进了 classmap（CI 构建漏了--no-dev），上线后反而加载测试类，还挤占有效空间 - 用了
"files": ["src/helpers.php"]，这类全局函数不进 classmap，也不受 authoritative 控制——但它本身不报错，只是不加速
怎么验证 classmap 真正生效了
不能只看命令是否成功，得查生成结果和运行行为：
- 检查
vendor/composer/autoload_classmap.php：文件非空、且大小合理（几百 KB 起步，含数千个类路径） - 用
strace -e trace=openat php -r 'new SomeClass();'（Linux）观察是否还大量openat扫描 .php 文件；优化后应只打开autoload_classmap.php和目标类文件 - 确认
opcache.revalidate_freq=0，否则每次请求都会检查 classmap 文件时间戳，白费优化 - 部署后若仍慢，先
opcache_reset()或重启php-fpm，避免旧 autoloader 缓存残留
classmap 是静态快照，不是魔法开关；它快的前提是路径稳定、命名规范、且没被其他 autoload 机制干扰。最容易被忽略的是：开了 --classmap-authoritative 却没清 OPcache，或者忘了 CI 构建时加 --no-dev，结果 classmap 里塞了一堆测试类。
