composer install --optimize-autoloader（或-o）是唯一真正生效的优化命令；它必须与--no-dev等组合使用，才能生成有效的autoload_classmap.php并避免开发类污染生产环境。
composer install -o 是唯一真正生效的命令
加 --optimize-autoloader（或简写 -o）必须出现在 composer install 或 composer update 命令中，才可能生成 vendor/composer/autoload_classmap.php。其他方式全无效：composer dump-autoload -o 不重建 classmap；"optimize-autoloader": true 写在 composer.json 里只是开关，不触发实际生成；CI/CD 脚本里漏掉 -o，线上 autoloader 就是未优化状态。
常见错误现象：vendor/autoload_classmap.php 文件为空或根本不存在，但命令看起来“带了 -o”——往往是因为用了 dump-autoload 而非 install。
-
composer install --no-dev --optimize-autoloader✅ 推荐组合，生产环境标准操作 -
composer update -oa✅ 等价于--optimize-autoloader --no-dev，适合依赖有变更时 -
composer dump-autoload -o❌ 不生成 classmap，只刷新静态映射表（如autoload_static.php） -
composer install后再补dump-autoload -o❌ 无意义，classmap 已固化，不会更新
为什么必须搭配 --no-dev？
--no-dev 不只是省空间，它直接决定 classmap 的内容边界。dev 依赖（如 phpunit、mockery）的类会被扫描进 classmap，导致映射表膨胀、内存占用上升，且这些类在生产环境根本用不到。
更关键的是：如果 dev 包里有同名类（比如测试用的 AppTestHelper），而生产代码又意外引用了它，classmap 会优先加载这个“不该存在”的类，引发难以复现的运行时错误。
- CI/CD 部署脚本中必须显式写
--no-dev，不能靠COMPOSER_NO_DEV=1环境变量替代（部分旧版 Composer 不识别） - 本地调试时加了
--no-dev，会导致vendor/bin/phpunit找不到类 —— 这不是 bug，是预期行为 -
autoload-dev下的路径不会被主 classmap 包含，哪怕你手动加了--optimize-autoloader
--classmap-authoritative 和 --apcu-autoloader 怎么配？
--classmap-authoritative 是激进模式：autoloader 完全信任 classmap，不再 fallback 到 PSR-4 目录扫描。它能进一步减少文件 I/O，但代价是——漏一个类就 Class not found。而 --apcu-autoloader 必须和 --optimize-autoloader 同时启用，否则 APCu 缓存的只是未优化的映射结构，毫无意义。
三者共用时顺序无关，但缺一不可：
-
composer install --no-dev --optimize-autoloader --classmap-authoritative --apcu-autoloader✅ 全开组合 - 启用
--apcu-autoloader后，首次请求会写入 APCu，后续直接命中；部署后必须清 APCu 缓存：php -r "apcu_clear_cache('user');" -
--classmap-authoritative会破坏某些动态注册逻辑（如 Laravel 的PackageServiceProvider中通过class_exists()触发的延迟加载），上线前务必全量验证 - APCu 必须启用且配置正确：
extension=apcu.so、apc.enabled=1、apc.shm_size=64M，Docker 中注意apc.enable_cli=0（FPM 需单独设为 1）
上线前必须人工验证的三个点
自动加了参数不等于优化真起效。classmap 是静态快照，一旦生成就和源码强绑定，任何偏差都会导致线上类加载失败。
最常被跳过的验证动作：
- 检查
vendor/composer/autoload_classmap.php是否包含你核心控制器类，比如搜索'App\Http\Controllers\HomeController'看路径是否指向app/Http/Controllers/HomeController.php - 确认没有遗留
__autoload或spl_autoload_register自定义逻辑，它们会干扰 classmap 查找路径 - 运行一次真实请求（如
curl -I http://localhost/health），同时打开 PHP 错误日志，看是否有PHP Warning: require(): Failed opening required类报错
复杂点在于：classmap 生成依赖于 composer.json 中 autoload 配置的完整性。少写一个 "src/" 目录，或文件名含下划线（My_Controller.php），都可能导致类名无法被扫描到——这时候加再多参数也没用。
