必须显式加 --optimize-autoloader 参数，否则即使 composer.json 中配置 "optimize-autoloader": true 也无效；该配置仅影响 dump-autoload，默认不作用于 install/update。
composer install 时怎么让 optimize-autoloader 生效
必须显式加 --optimize-autoloader 参数，否则即使 composer.json 里写了 "optimize-autoloader": true 也没用。Composer 只在生成 autoloader 时（即 install 或 update）读取这个配置，但默认不触发优化逻辑。
常见错误是只改了配置却没加参数，结果 vendor/autoload.php 还是未优化的散列文件加载方式，类加载慢一倍以上。
- 正确命令：
composer install --optimize-autoloader --no-dev -
--no-dev要一起加，否则 dev 包也会被加载进优化后映射，浪费内存和磁盘空间 - CI/CD 中漏掉该参数，会导致线上环境 autoloader 没优化，性能直接受损
为什么不能只靠 composer.json 的 optimize-autoloader 配置
这个字段只是个“开关提示”，不是运行时行为控制项。它只影响 composer dump-autoload 是否默认启用优化，而 install 和 update 命令本身有自己独立的参数决策逻辑。
换句话说："optimize-autoloader": true 在 composer.json 里，等价于下次你手动执行 composer dump-autoload 时自动带上 --optimize-autoloader，但它对 install 完全无效。
- 验证方法：删掉
vendor，执行composer install（不带参数），然后看vendor/composer/autoload_classmap.php是否存在——不存在就说明没优化 - 生产部署脚本里如果只写
composer install，99% 情况下都没开优化
optimize-autoloader 对 classmap 和 PSR-4 的实际影响
开启后，Composer 会把所有能静态分析到的类路径，提前打成一张大数组（autoload_classmap.php），跳过文件系统遍历和命名空间转换。但前提是类声明必须规范——比如 PSR-4 下，类名与文件路径严格对应；否则那些“动态 require”或“eval 类定义”的代码会被直接忽略。
- 只优化
classmap和 PSR-0/PSR-4 中可推导的类，不处理files数组里的全局函数文件 - 如果你用了 Laravel 的
class_alias或运行时注册类，它们不会出现在 classmap 里，仍需按原路径加载 - 大型项目开启后，
vendor/autoload.php加载速度提升明显，但首次install时间略长（要扫描所有 PHP 文件）
生产环境推荐的一行 composer install 命令
别拆成多步，也别依赖 CI 环境变量去条件判断。最稳的方式就是固定用这一行：
composer install --optimize-autoloader --no-dev --prefer-dist --quiet
其中 --prefer-dist 减少解压开销，--quiet 避免日志干扰部署流程。漏掉任意一个，都可能让优化失效或引入非必要依赖。
特别注意：--optimize-autoloader 必须和 --no-dev 同时出现，否则 dev 专用包（如 phpunit、laravel/pint）的类也会被塞进 classmap，白占内存、拖慢加载、还可能引发运行时冲突。
