必须加 --optimize-autoloader 是因为 composer install --optimize-autoloader 会完整执行依赖锁定、下载、扫描并生成与 composer.lock 严格一致的 autoload_classmap.php，而 dump-autoload -o 仅重写映射且不更新依赖信息，易导致类找不到或加载慢。
composer install --optimize-autoloader 为什么必须加，而不是 dump-autoload -o
生产环境类加载慢，90% 不是类本身的问题，而是 vendor/autoload.php 每次加载时反复扫描目录、调用 file_exists() 和 stat()。真正起效的不是 composer dump-autoload -o，而是 composer install --optimize-autoloader —— 后者在安装依赖的同时重建 autoload_classmap.php，前者只是重写一个可能早已过期或根本不存在的文件。
常见错误现象：Class not found 报错、首页加载卡顿超时，往往就是只跑了 dump-autoload -o 却没跑 install，导致 classmap 里压根没你新加的类。
-
dump-autoload -o不触发依赖解析，也不更新vendor/composer/installed.json，它只管“重写映射”，不管“映射对不对” -
install --optimize-autoloader会完整走一遍依赖锁定 → 下载 → 扫描 → 写入 classmap 流程，确保映射与当前composer.lock严格一致 - PHP 7.4+ + Composer 2.x 下，
-o生成的autoload_classmap.php常达数 MB，每次请求都得全量 require 进内存；而实际单次请求只用到其中不到 5% 的类
--classmap-authoritative 开了就 Class not found？先查 classmap 有没有这个类
--classmap-authoritative（或 -a）不是加速开关，是断言模式：查不到就直接报错，不 fallback 到 PSR-4 路径拼接。报错说明 classmap 不完整，不是配置错了。
检查方法很简单：打开 vendor/composer/autoload_classmap.php，搜索你的类名，比如 AppConsoleCommandsDeployCommand。漏掉的常见原因：
- 命名空间末尾少反斜杠：
"App": "app/"是对的，"App": "app/"是错的（注意末尾是否带） -
autoload-dev里的路径被误混进主 autoload（没加--no-dev） - 用了
"files"类型加载（如全局函数文件），这类不会进 classmap，但开了-a后仍能运行——别误以为所有 autoload 都该在 classmap 里 - 项目中存在非标准结构（插件目录、模板逻辑文件）被 classmap 扫描但未正确注册
autoload 配置写错，比不加优化参数更拖慢启动
Composer 2 默认已生成轻量高效的 autoload_static.php，它比 classmap 更适合 OPcache 缓存。但如果你的 composer.json 里写了这些，性能反而更差：
-
"docs/": ["docs/"]或"tests/": ["tests/"]：让 classmap 白扫几百个文件，徒增体积 -
"": ["legacy/"]（空前缀）：触发全盘递归扫描，哪怕 legacy/ 下只有 1 个 .php 文件，也会遍历整个目录树 -
"App\": "app/"同时出现在psr-4和classmap中：Composer 会叠加处理，匹配耗时翻倍 - 测试类没放
autoload-dev块里，导致生产部署时autoload_psr4.php里混进Tests路径
删掉这些无效配置，比硬加 -o 真实提速更明显。
CI/CD 流水线里只写一行命令就够
别在构建脚本里拆成 composer install + composer dump-autoload -o + composer run-script optimize。生产打包唯一正确命令就是：
composer install --no-dev --optimize-autoloader
它同时做到三件事：跳过 require-dev 包（如 phpunit）、生成 classmap、禁用 dev 相关 autoload 规则。漏掉任意一个参数，都可能导致线上 Class not found 或冷启动多花 3–5ms、内存多占 1MB+ —— 对 CLI 脚本或 Serverless 场景尤为敏感。
额外提醒：这个命令必须在目标环境（或构建机）上执行，不能只在本地跑一遍就打包。而且 composer.lock 必须随包一起分发，它是依赖版本锁定的唯一依据。
