composer dump-autoload -o 仅对手动注册的非标准路径类文件有效，现代 Composer 2+ 应优先使用 –classmap-authoritative 配合 –no-dev –optimize-autoloader，并确保启用 opcache。
composer dump-autoload -o 在生产环境确实能提升类加载性能，但它的作用被高估了——它只优化自动加载映射（classmap），对 PSR-4/PSR-0 自动发现路径无加速效果，且在现代 Composer 2+ 中默认已启用更优的 classmap-authoritative 模式。
什么时候该用 dump-autoload -o？
仅当项目中存在大量非标准路径的文件（如散落在 src/ 外的 .php 文件），且这些文件通过 "classmap": ["..."] 手动注册时，-o 才有意义。它会把这些路径下的所有类一次性扫描进 vendor/composer/autoload_classmap.php，避免运行时遍历目录。
- 典型场景：遗留系统里混用了
include+ 类名硬编码，又没迁移到 PSR-4 - 不适用场景：纯 PSR-4 项目（如 laravel、symfony 默认结构）——此时
-o不产生任何 classmap 条目 - 验证方式：执行后检查
vendor/composer/autoload_classmap.php是否有非空数组内容
-o 和 --classmap-authoritative 的区别
-o 是旧版开关，而 --classmap-authoritative（或配置 "classmap-authoritative": true）才是 Composer 2 推荐的权威模式：它强制所有类必须出现在 classmap 中，彻底跳过 PSR-4 的文件系统查找。这对生产部署更安全、更快。
-
dump-autoload -o：生成 classmap，但运行时仍 fallback 到 PSR-4 查找（如果类没在 map 里） -
dump-autoload --classmap-authoritative：生成 classmap 后，直接报错“Class not found”，不尝试磁盘扫描 - CI/CD 中建议用后者，并配合
--no-dev和--optimize-autoloader（即-o）一起使用
生产环境真正有效的 autoload 优化组合
单靠 -o 几乎无效。完整优化需三步闭环：
- 确保
composer.json中移除开发依赖：require-dev不应出现在生产镜像中 - 安装时加参数：
composer install --no-dev --optimize-autoloader --classmap-authoritative - 确认 autoloader 使用的是
vendor/autoload.php，而非自己封装的 require 链（会绕过优化） - 注意 APCu 缓存：PHP 7.4+ 下开启
opcache.enable=1和opcache.save_comments=0对 autoload 性能影响远大于-o
最容易被忽略的一点：dump-autoload -o 本身不改变已安装包的加载行为——它只影响你本地写的代码。真正决定生产性能的是 install 时是否启用权威 classmap 模式，以及 opcache 是否生效。