composer dump-autoload -o 不加速加载，仅重写轻量映射表；真正提速需 install --no-dev --optimize-autoloader --classmap-authoritative 显式配置 classmap 目录并配合 OPcache 预加载。
composer dump-autoload 本身不是加速入口，而是配置结果的“刷新动作”；真正影响速度的是你有没有让 Composer 去扫对目录、生成有效的 autoload_classmap.php，以及是否在错误场景下滥用 -o。
为什么 dump-autoload -o 在大型项目里常变慢
它不重建 classmap，只重写轻量映射表（autoload_static.php 和 PSR-4 规则），而 autoload_classmap.php 文件要么为空，要么极稀疏——你看到“优化成功”，但实际类加载仍走 file_exists() + 路径拼接 + 目录遍历。
- 检查
vendor/composer/autoload_classmap.php：如果数组长度不到 100 行，说明没扫到业务类 -
-o在 PHP 7.4+ / Composer 2.x 下会生成几 MB 的全量 classmap，每次请求都要反序列化整个数组，而单次请求只用到其中不到 5% 的类 - OPcache 难以高效缓存这种动态结构的大数组，反而拖慢冷启动
- 本地开发中长期开
--optimize-autoloader容易掩盖命名空间拼写错误（比如namespace AppConsoleCommands;缺反斜杠），调试更难定位
真正要跑的命令不是 dump-autoload -o，而是 install --optimize-autoloader
composer dump-autoload -o 不触发 classmap 全量扫描；只有 composer install --no-dev --optimize-autoloader --classmap-authoritative 才会强制重新解析所有 autoload 配置、生成精简 classmap，并跳过 vendor 缓存逻辑。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- CI/CD 部署脚本必须固定写这条：
composer install --no-dev --optimize-autoloader --classmap-authoritative - 加
--no-dev是硬性前提：否则tests/、examples/会被扫进 classmap，徒增体积、浪费内存 -
--classmap-authoritative不是“加速开关”，而是“断电式加载”：查不到就直接报错，不再 fallback 到 PSR-4 —— 这能砍掉大量无效stat()调用，但在高并发下才有明显收益 - 执行后务必验证：
vendor/composer/autoload_real.php中是否调用了$loader->addClassMap($map)；若只有setPsr4，说明 classmap 根本没生效
classmap 目录必须显式声明，不能靠自动发现
Composer 默认不会把 app/、common/、library/ 这些稳定模块扫进 classmap，除非你在 composer.json 里明确写进 "classmap" 字段。
- 补全配置示例：
"classmap": ["app/", "common/", "library/Utils/"] - 删掉重复声明：比如同时存在
"App\": "app/"（PSR-4）和"app/"（classmap），会导致同一类注册两次 - 绝对不要把
tests/、examples/、docs/塞进classmap或 PSR-4 配置——它们拉长扫描时间，且无运行时价值 - ThinkPHP 的
app/默认不在 classmap 里，必须手动加；但加之前确认没在config/app.php的class_map里重复声明过相同类
OPcache 和预加载才是最终防线
再好的 classmap，没有 OPcache 支持也白搭。autoload 阶段的瓶颈往往不在查找逻辑，而在文件 I/O 和 opcode 解析。
- 确保
opcache.enable=1、opcache.memory_consumption ≥ 128M、opcache.revalidate_freq=0（生产环境刚需） -
opcache.preload是终极提速手段：在 PHP-FPM 启动时就把核心类编译驻留内存，彻底绕过 autoloader —— 但 preload 文件里只能用require，禁止class_exists、new等运行时操作 - APCu 缓存 classmap 内容的前提是
apcu.enable_cli=1；部署后建议加apcu_clear_cache('user')，避免旧映射残留 -
composer install --apcu-autoloader在 CLI 下完全不生效，别被文档误导
classmap 不是万能钥匙，它是把双刃剑：扫得宽，生成慢、体积大、冷启动更卡；扫得窄，漏类就直接炸。真正关键的不是“要不要 dump”，而是“扫哪些目录、怎么配、谁来缓存”。
