生产环境必须使用 composer install --no-dev --optimize-autoloader --classmap-authoritative --no-interaction，缺一不可：--no-dev 排除开发依赖，--optimize-autoloader 生成静态类映射，--classmap-authoritative 强制仅查 classmap 提速，--no-interaction 避免 CI/CD 卡住。
生产环境必须用 composer install --no-dev --optimize-autoloader --classmap-authoritative --no-interaction
这不是“推荐组合”，而是唯一能同时满足安全、速度、确定性的命令。少一个参数，就可能线上报错或冷启动变慢。
常见错误现象：本地 composer dump-autoload -o 跑通了，一上生产就 Class not found；或者 composer install --no-dev 后 autoload 仍慢得像没优化——本质是漏了关键参数。
-
--no-dev：跳过require-dev包（如phpunit、laravel-debugbar），防止它们污染 classmap 或意外启用调试逻辑 -
--optimize-autoloader（或-o）：触发完整扫描，把 PSR-4 映射转为vendor/composer/autoload_classmap.php中的静态路径条目 -
--classmap-authoritative（或-a）：强制 autoloader 只查 classmap，彻底禁用file_exists()和目录遍历，这是提速核心 -
--no-interaction：避免 CI/CD 或 Docker 构建时因无 TTY 卡在交互提示（比如 license 确认）
注意：dump-autoload 命令在 Composer 2.0+ 中已不重建 classmap，它只是轻量刷新，不能替代 install 阶段的完整扫描。
为什么加了 --classmap-authoritative 却还报 Class not found？
这不是配置失败，而是 classmap 漏掉了运行时实际用到的类。权威模式是“全或无”断言，不会 fallback。
检查这三处：
- 命名空间路径末尾缺反斜杠：
"App": "app/"✅，写成"App": "app"❌ → PSR-4 扫描失效，类进不了 classmap - 类文件存在但命名空间拼错：比如
app/Console/Commands/DeployCommand.php里写了namespace AppConsoleCommands;（缺\分隔符），classmap 就不会收录它 - 误把
tests/、examples/目录塞进了autoload或autoload-dev块 → 它们被跳过扫描，但若代码里硬写了new TestsFooTest()，运行时直接崩
验证方式：打开 vendor/composer/autoload_classmap.php，搜索你刚加的类全名（如 AppConsoleCommandsDeployCommand），看是否在数组里。
镜像源只加速下载，不解决 autoload 重建慢的问题
配了阿里云镜像却还是卡 2 分钟？大概率卡在 Resolving dependencies 或 autoload 重建阶段，和镜像无关。
真正影响生产部署速度的环节有三个：
- 依赖解析：由
composer.lock是否干净决定。含require-dev记录、minimum-stability设为dev、或没提交 lock 文件，都会让install退化为update - 包下载：镜像只管这一步。验证是否走镜像：加
-vvv看日志里请求的是https://mirrors.aliyun.com/composer/packages.json，不是packagist.org - autoload 重建：只有
install或update阶段才执行。CI/CD 脚本里如果先dump-autoload -o再install，等于白干
配置镜像必须四要素全对：repo.packagist（单数、无 s）、type 值为 composer、URL 以 https:// 开头且结尾带 /、执行时带 -g。验证命令：composer config -g repo.packagist 输出必须是完整 JSON 对象。
CI/CD 构建前必须清理 composer.lock 中的 dev 信息
composer.lock 里存着 require-dev 的版本快照，即使加了 --no-dev，Composer 仍会解析这部分内容，可能导致主依赖降级或冲突。
上线构建前应跑一次：
-
composer update --no-dev -o：强制刷新 lock 中 production 部分，并生成优化 autoload -
grep -q '"require-dev"' composer.lock && echo "warning: dev section exists" || echo "clean"：快速检查 lock 是否干净 - 确认
composer.lock已加入 Git 暂存区：CI 拉的是远程分支的 lock，不是你本地改完没 commit 的那个
容易被忽略的一点：autoload_classmap.php 文件体积暴涨（几 MB）≠ 优化生效。如果里面混进了 tests/、docs/ 路径，反而会让 opcache 反序列化更重，比 PSR-4 拼路径还慢。删掉 composer.json 中无效的 autoload 条目才是关键。
