composer install --optimize-autoloader 没效果是因为未启用权威模式，需同时指定 --classmap-authoritative 或在 composer.json 中配置 "classmap-authoritative": true，否则仍执行 psr-4 运行时文件查找。
为什么composer install --optimize-autoloader没效果
因为单独加 --optimize-autoloader（或 -o）不会跳过 PSR-4 运行时查找，autoloader 仍会拼路径、调用 stat()、检查文件是否存在。真正起效的前提是同时启用“权威模式”——要么命令行加 --classmap-authoritative，要么在 composer.json 的 config 块里写 "classmap-authoritative": true。
- 漏掉
--classmap-authoritative：autoload_real.php 里依然保留foreach ($this->prefixesPsr4 as ...)分支，I/O 开销照旧 -
composer.json里没配"classmap-authoritative": true：某些 Composer 2.2+ 版本会忽略命令行参数，导致权威模式实际未启用 - 用了
--no-dev却没清理autoload-dev声明：测试类仍被注册进 loader，匹配路径时多扫一圈
composer dump-autoload -o 为什么不能用于生产部署
composer dump-autoload -o 在 Composer 2.x 中已不是“生成 classmap”的等价操作，它只刷新 autoload_static.php 和 PSR-4 映射，**不扫描文件、不写入 vendor/composer/autoload_classmap.php**。你看到的空文件或 <?php return array(); 就是典型信号。
- CI/CD 构建时若只跑这句，新依赖里的类根本不在 classmap 中，上线后必报
Class not found - 它不处理
require-dev包的 autoload 规则，tests/或docs/路径可能仍混进映射 - 本地能跑、线上炸锅，往往是因为
dump-autoload没触发真实 classmap 重建，而install阶段才做这事
opcache.enable_cli=1 为什么必须开
不开 opcache.enable_cli=1，composer install 生成的 autoload_classmap.php 就无法被 opcache 缓存——每次 PHP 请求都得重新解析那个几 MB 的数组，反而比不优化更慢。很多人只开了 opcache.enable=1，却忘了 CLI 模式下也要启用。
- 验证方式：执行
php -d opcache.enable=1 -d opcache.enable_cli=1 -r "var_dump(opcache_get_status()['scripts']['vendor/composer/autoload_classmap.php'] ?? 'not cached');" - PHP-FPM 环境下还需确认
opcache.revalidate_freq=0，否则时间戳校验会频繁失效缓存 - Docker 构建时，该配置必须写进
php.ini或通过docker-php-ext-enable启用，不能只靠运行时-d
怎么验证 classmap 是否真生效
别只看命令是否成功，关键看最终加载器行为。打开 vendor/autoload.php，搜索 ClassLoader->addClassMap；再打开 vendor/composer/autoload_real.php，确认 findFile() 方法里只剩 if ($classMap = $this->classMap) 分支，且完全删掉了 PSR-4 相关循环逻辑。
- 检查
vendor/composer/autoload_classmap.php是否非空：小项目几百 KB、Laravel 项目常达 2–5 MB 是正常现象；若只有几十行或为空，说明 classmap 根本没生成 - 用
strace -e trace=stat,openat php -r "new \App\Http\Controller\Home();"观察是否还有大量stat("/vendor/...")失败调用；仍有就说明 fallback 还在走 - 搜索
autoload_classmap.php里有没有你要用的类名（如AppConsoleCommandsDeployCommand），没有就说明命名空间配置漏了反斜杠或路径不对
composer install --no-dev --optimize-autoloader --classmap-authoritative 当成一步命令，却没同步确保 opcache.enable_cli=1 生效，也没验证 autoload_real.php 是否真的删掉了 PSR-4 查找分支。这些环节缺一不可，漏掉任何一个，优化就等于没做。
