真正有效的提速方式是生成并启用权威类映射（classmap-authoritative），必须配合 -o 参数和正确配置，否则无效；默认 dump-autoload 不扫描文件，需加 -o 才生成 autoload_classmap.php 并启用 APCu/OPcache 缓存。
类加载慢不是 Composer 本身卡，而是 vendor/autoload.php 每次都要拼路径、调 file_exists()、遍历目录 —— 这个开销在 PHP-FPM 高并发下会被放大几十倍。真正有效的提速方式只有一条：生成并启用权威类映射（classmap-authoritative），但必须配合 -o 和正确配置，否则白忙。
为什么 composer dump-autoload 跑了还是慢？
默认命令不扫描文件，也不生成 autoload_classmap.php。它只重写基础命名空间映射和 autoload_files.php，类加载仍依赖运行时 I/O 查找。
- 必须加
-o（即--optimize）才触发全量扫描，把所有class/interface/trait名硬编码进数组 - 检查
vendor/composer/autoload_classmap.php：为空或只有几 KB，说明没生效 - 用
strace -e trace=openat php -r 'new \App\Http\Controller\HomeController();'观察是否还在大量openat.php 文件 —— 优化后应只剩 2–3 次系统调用
composer install --optimize-autoloader 和 dump-autoload -o 有什么区别？
前者是安装时顺带生成，后者是独立重建。两者都需 -o 才有效，但行为边界不同：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer install --optimize-autoloader：只对composer.json中已声明的autoload和autoload-dev路径生效；若你漏写了"app/Exceptions/"，它就不会被扫进去 -
composer dump-autoload -o：严格按composer.json的autoload.classmap字段扫描，哪怕你把"src/"写成"src"（缺末尾斜杠），整个目录都会被跳过 - CI/CD 中建议用
composer install --no-dev --optimize-autoloader --classmap-authoritative一步到位，避免多步出错
--classmap-authoritative 开了却报 Class not found？
这不是 bug，是它在严格执行“查不到就真没有”。常见漏类原因很具体：
-
"App\": "app/"写成"App": "app/"（少了反斜杠），Composer 解析时直接跳过整个app/目录 - 新增类文件如
app/Console/Commands/DeployCommand.php，但类声明是class DeployCommand，而命名空间却是namespace AppConsoleCommands;（缺\分隔符） -
autoload-dev下的路径被误扫进生产 classmap：比如 CI 构建时没加--no-dev，导致Tests\类也进了autoload_classmap.php，上线后体积暴涨、还可能干扰 autoload 行为 - 某些框架（如 Laravel）在启动时 patch 了
ClassLoader，手动调用了setUseIncludePath()或清空了$classMap，让权威模式退化
APCu 和 OPcache 不配，classmap 就白干
类映射表再快，如果每次请求都要重新读取并反序列化大数组，性能提升就打折扣。APCu 缓存的是数组内容本身，OPcache 缓存的是 autoload_classmap.php 文件字节码。
-
"apcu-autoloader": true必须写在composer.json的config段，不是autoload段 - PHP 必须已启用
apcu扩展，且 CLI 模式下apcu.enable_cli=1（FPM 环境通常默认开启） - OPcache 必须同时开启
opcache.enable=1和opcache.enable_cli=1，否则vendor/autoload.php自身都无法被缓存 - 部署后务必执行
apcu_clear_cache('user')，否则旧 classmap 可能继续生效
真正容易被忽略的点是：classmap 是静态快照，不是实时索引。它不会感知文件增删，也不会兼容运行时 require 的未声明类 —— 这些都不是缺陷，而是设计前提。用错场景，比不用更麻烦。
