生产环境应使用 composer install --no-dev --optimize-autoloader 才是真优化，它强制重建精简 classmap；单独 dump-autoload -o 不生成 autoload_classmap.php，属假优化。
生产环境加 --optimize-autoloader 有效，但必须配合 --no-dev；单独在开发机上跑 composer dump-autoload -o 基本没用，甚至可能更慢。
为什么 composer dump-autoload -o 在大多数项目里是假优化
它默认不生成或更新 vendor/composer/autoload_classmap.php，只刷新轻量级的 autoload_static.php 和 PSR-4 映射表。真正的 classmap 文件只在 install 或 update 阶段重建。
- 执行
composer dump-autoload -o后检查vendor/composer/autoload_classmap.php：文件不存在或大小为 0 → 没生效 - 即使存在，若
composer.json中没声明"classmap"数组，Composer 2.x 会跳过 classmap 扫描，-o只是空转 - PHP 7.4+ 下，全量
autoload_classmap.php反序列化开销大，而实际请求只用到其中不到 5% 的类，内存和 CPU 反而吃亏
composer install --no-dev --optimize-autoloader 才是真动作
这条命令强制 Composer 重新解析所有 require 包（不含 require-dev），并基于当前 autoload 配置生成精简 classmap —— 这才是生产部署该写的 CI/CD 步骤。
- 确保
autoload-dev里的路径（如"tests/": ["tests/"]）没泄露进主autoload块，否则测试类也会被扫进 classmap，白白膨胀文件 - 运行后对比
vendor/composer/autoload_classmap.php大小：生产版应比开发版小 30% 以上 - 验证是否真走 classmap：删掉某个类文件，再
class_exists()测试——若直接报错而非 fallback 到 PSR-4 查找，说明 classmap 已生效
--classmap-authoritative 开了就报 Class not found？先查这三处
这个参数不是“加速开关”，而是“断电式加载”：类不在 classmap 里就立刻失败，不尝试任何 fallback。报错不是配置错，是 classmap 漏了类。
-
composer.json中 PSR-4 命名空间末尾缺反斜杠，例如写成"App": "app/"而非"App\": "app/"→ 扫描失败，类进不了 classmap - 新增类文件但命名空间与目录结构不严格匹配，比如
app/Console/Commands/DeployCommand.php里写namespace AppConsoleCommands;（中间缺反斜杠）→ 不会被识别 - 用了
"files": ["app/Helpers/functions.php"]加载全局函数，这类文件不会进入 classmap；开了--classmap-authoritative后它们仍能加载（因 files 是独立逻辑），但容易误判为 autoload 整体失效
真正拖慢 autoload 的，往往藏在 composer.json 配置里
比起加参数，清理 autoload 规则对性能影响更大。一个臃肿的 autoload_psr4.php 比 classmap 更隐蔽地拖垮请求。
- 删掉无用条目：
"docs/": ["docs/"]、"legacy/": ["legacy/"]、"tests/": ["tests/"]—— 它们会让 Composer 白扫几百个文件 - 合并重叠前缀：把
"AppHttpControllers\": "app/Http/Controllers/"和"AppHttpMiddleware\": "app/Http/Middleware/"合并为"AppHttp\": "app/Http/" - 避免宽泛前缀：
""（空字符串）或"MyLib\*": "src/"不合法且触发全目录递归扫描，Composer 会忽略或报错 - 确认没有重复注册：同一命名空间同时出现在
psr-4和classmap中 → Composer 叠加处理，增加匹配耗时
最常被忽略的一点：classmap 一旦生成，composer install 不会自动更新它——改了类名、挪了文件、增了新类，都得手动重跑完整安装流程。别指望它像 PSR-4 那样“热感知”。
