composer install --optimize-autoloader 是重建 classmap 的唯一正统入口，它扫描 autoload 路径生成 vendor/composer/autoload_classmap.php 纯数组文件，启用后 findFile() 仅依赖 classMap 分支，大幅减少系统调用。
composer install --optimize-autoloader 不是“优化一下 autoload”，而是重建 classmap
它真正干的事，是在安装依赖的同时，扫描 composer.json 中所有 autoload 声明的路径（如 "App\": "app/"），把所有能识别的类、接口、trait 全部写进 vendor/composer/autoload_classmap.php。这个文件是纯 PHP 数组，加载时直接 require，不走任何目录遍历或 file_exists() 判断。
常见错误现象：composer dump-autoload -o 后发现 autoload_classmap.php 没变、还是空的、或者只有几 KB —— 因为 dump-autoload 默认不重建 classmap，它只刷新 autoload_static.php 和 PSR-4 映射表。
-
install --optimize-autoloader是 classmap 的唯一正统生成入口（update也可以，但生产环境不该用update） - 只改了代码没动依赖？别用
install，该用composer dump-autoload --optimize-autoloader --no-dev（注意不是-o，是完整参数） - 如果
autoload_classmap.php文件不存在，或大小
为什么必须搭配 --no-dev 才算真生效
--no-dev 不只是“不装测试包”，它直接影响 classmap 内容是否干净：dev 包里的类（比如 phpunit/phpunit 的 TestCase、Mockery 的 mock 类）一旦被扫进 classmap，就会污染映射表，导致生产环境加载慢、OPcache 缓存效率低，甚至引发命名冲突。
-
require-dev中的包，其autoload配置默认也会被扫描 —— 除非加了--no-dev - 漏掉
--no-dev，autoload_classmap.php里可能出现"PHPUnit\Framework\TestCase"这类明显不该上线的类名 - Laravel 项目中，
Tests/目录若被误写进主autoload（而非autoload-dev），加不加--no-dev都会进 classmap
--classmap-authoritative 不是加速开关，是加载策略切换
加了 --classmap-authoritative（或简写 -a），Composer 就彻底放弃 fallback 行为：类名不在 autoload_classmap.php 里，就直接抛 Class not found，不再尝试拼路径、不再调 is_file()、不再遍历 app/ 下每个子目录。
- 报错不是配置错了，是 classmap 漏了类 —— 比如新增了
app/Console/Commands/DeployCommand.php，但命名空间写成namespace AppConsoleCommands;（缺反斜杠），PSR-4 扫描失败，classmap 里就没有它 -
files类型加载（如全局函数文件）不受影响，它们走独立逻辑，和 classmap 无关 - 框架运行时动态绑定的类（如 Laravel
AppServiceProvider::boot()里$this->app->bind()）本来就不在 autoload 范围内，跟-a无关
验证是否真的启用了优化加载
别只看命令有没有跑，得看运行时行为是否改变。最直接的验证方式是检查 vendor/composer/autoload_real.php 的 findFile() 方法：优化且启用权威模式后，里面应该只剩一个 if ($classMap = $this->classMap) 分支，没有任何 foreach 循环或 file_exists() 调用。
- 用
strace -e trace=openat php -r 'new AppHttpControllersHomeController();'观察系统调用次数：优化后应只剩 2–3 次openat，未优化时可能达几十次 -
ls -lh vendor/composer/autoload_classmap.php：存在 + 大小 >100KB + 内容含你项目绝大多数类名，才算落地 - CI/CD 脚本里别只写
composer install，必须固化为composer install --no-dev --optimize-autoloader --classmap-authoritative
classmap 不是“设了就一劳永逸”的东西 —— 新增类、改命名空间、挪文件位置，都得重跑 install 或带完整参数的 dump-autoload；否则 --classmap-authoritative 会让你在上线后第一秒就遇到 Class not found。
