composer install --optimize-autoloader 在生成 vendor/composer/autoload_classmap.php 时生效，仅固化 PSR-4/PSR-0 类映射，不加速运行时查找；需配合 --no-dev 使用，且依赖 APCu 或 OPCache 清理才能真正生效。
composer install --optimize-autoloader 什么时候才真正生效？
它只在生成 vendor/autoload.php 时起作用，且仅影响 PSR-4/PSR-0 类的自动加载路径映射——不是“让 autoload 更快”，而是把类名到文件路径的映射提前固化进 vendor/composer/autoload_classmap.php，跳过运行时遍历目录。
常见错误现象：composer install --optimize-autoloader 后 php -d display_errors=1 -r "var_dump(class_exists('App\Http\Controller'));" 仍返回 false，其实是类本身没被正确声明或命名空间写错，和是否优化无关。
- 必须配合
--no-dev使用（生产环境不该加载 dev 依赖，否则 classmap 会混入测试类） - 如果项目用了
classmap配置（如"classmap": ["src/"]），优化后该目录下所有 PHP 文件都会被无条件扫入 classmap，哪怕没声明 class —— 可能引发 parse error - Composer 2.2+ 默认启用
apcu缓存 classmap，但前提是 APCu 扩展已启用且未被禁用（apc.enable_cli=1对 CLI 模式也有效）
为什么 vendor/autoload.php 里看不到 classmap 加载逻辑？
因为优化后的 classmap 不是硬编码进 autoload.php，而是由 vendor/composer/autoload_real.php 动态引入 autoload_classmap.php。这个文件只有在执行 composer dump-autoload --optimize 或带 --optimize-autoloader 的安装/更新后才会生成。
使用场景：部署时 CI/CD 脚本里，别只写 composer install，漏掉优化参数会导致首次请求慢 200–500ms（尤其 Laravel、Symfony 等大框架）。
- 检查是否生效：运行
ls vendor/composer/autoload_classmap.php，存在即说明 classmap 已生成 - 如果项目含大量小工具类（如
src/Helpers/*.php），建议显式加进composer.json的classmap字段，否则--optimize-autoloader不会扫描它们 -
autoload-dev下的 classmap 不会被主 autoload 引入，即使加了--optimize-autoloader—— 这是设计使然，不是 bug
--optimize-autoloader 和 --classmap-authoritative 有什么区别？
前者是“补充 classmap”，后者是“强制只走 classmap”——开启后者后，Composer 会完全跳过 PSR-4/PSR-0 的文件系统查找逻辑，哪怕某个类没出现在 classmap 里，也会直接报 Class not found，而不是尝试去目录下找。
性能影响明显：在容器化部署中，--classmap-authoritative 可减少约 30% 的 stat() 系统调用，但代价是灵活性归零。
- 必须确保所有类都已被扫描进 classmap（比如执行前先
composer dump-autoload --optimize） - Laravel 9+ 在
APP_ENV=production下默认启用此选项，但如果你手动改过composer.json的 autoload 配置，可能失效 - 某些热重载工具（如
symfony/runtime的 dev server）不兼容该选项，会卡在 autoload 阶段
CI/CD 部署脚本里最容易漏掉的一步
很多人写了 composer install --no-dev --optimize-autoloader，却忘了清空 OPCache 或 APCu 缓存 —— 尤其当部署到已有进程的服务器（如 PHP-FPM）时，旧的 autoload 文件可能还在内存里。
真实错误现象：新版本上线后，部分类突然找不到，重启 PHP-FPM 后恢复；或者 opcache_get_status()['scripts'] 里还存着旧的 vendor/composer/autoload_real.php 路径。
- 推荐在部署末尾加一行：
php -r "opcache_reset();"（需opcache.enable_cli=1） - 如果用 APCu，执行
php -r "apcu_clear_cache();" - 更稳妥的做法：把
vendor/目录设为符号链接，每次部署生成全新vendor_20240520，再原子切换，避免缓存残留问题
classmap 一旦生成就固定，但它的生效依赖整个 autoload 链路的干净状态。缓存、权限、符号链接层级，任何一个环节出岔子，前面所有优化都白做。
