加--optimize-autoloader本身不提速，仅生成autoload_classmap.php；真正提速需同时用--no-dev或设"classmap-authoritative":true，否则classmap不被优先使用。
加 --optimize-autoloader 本身不提速，它只生成 autoload_classmap.php；真正提速的前提是：你必须同时用 --no-dev 或设 "classmap-authoritative": true，否则 classmap 压根不被优先使用。
为什么 composer install --optimize-autoloader 在本地没感觉变快
开发环境下默认加载器仍保留 PSR-4 fallback 路径，autoload_classmap.php 虽生成，但只是“备选”，不会跳过文件系统查找。只有满足以下任一条件，classmap 才真正接管加载：
-
composer install --no-dev --optimize-autoloader（dev 包类不进 classmap，避免污染） -
composer.json中配置"classmap-authoritative": true（强制只查 classmap） - 手动删掉
vendor/composer/autoload_static.php里的$fallbackDirsPsr4和$prefixLengthsPsr4（验证用，勿在生产环境操作）
composer dump-autoload -o 基本无效，别再用了
这个命令从不重建 autoload_classmap.php，它只刷新 autoload_static.php 和 PSR-4 映射表。常见翻车场景：
- CI 脚本写成
composer dump-autoload -o && composer install --no-dev→ classmap 是旧的，因为install阶段没带-o -
composer.json没声明"classmap": []，也没在autoload里配路径 →-o根本不触发扫描 - 执行后检查
vendor/composer/autoload_classmap.php：为空或不存在 → 说明压根没生效
生产部署唯一可靠命令
CI/CD 或 Docker 构建中，必须固化这条命令，缺一不可：
composer install --no-dev --optimize-autoloader --prefer-dist
原因：
-
--no-dev确保测试类、开发工具类不混入 classmap，减小体积、避免误加载 -
--optimize-autoloader触发完整 classmap 构建（扫描所有autoload声明的 PSR-4/classmap 路径） -
--prefer-dist加速下载，且 dist 包通常已预编译，与 classmap 更兼容
验证是否真生效：检查 vendor/composer/autoload_real.php 是否调用了 $loader->addClassMap()；再删一个已知类文件，运行 class_exists('SomeClass') —— 若直接返回 false（而非尝试 fallback 查找），说明 classmap 已权威启用。
容易被忽略的底层依赖
classmap 加载快的前提是 PHP 的 opcode 缓存稳定工作：
- PHP 7.4+ 默认启用 OPcache，但需确认
opcache.enable=1且opcache.validate_timestamps=0（生产环境） -
autoload_classmap.php是个大数组，若 OPcache 内存不足（如opcache.memory_consumption ），它可能被挤出缓存，反而更慢 - 动态类名（如
$class = $prefix . $name; new $class();）、eval()、匿名类、class_alias()等无法静态分析的代码，压根不会进 classmap —— 开了也白开
