composer install --optimize-autoloader 是生产环境唯一正确选择，因其在安装依赖时生成扁平化类映射表，跳过PSR-4动态解析，搭配--no-dev可排除dev包干扰，而dump-autoload -o不重建classmap且无法清理dev依赖。
为什么 composer install --optimize-autoloader 是生产环境唯一正确选择
生产环境类加载速度直接取决于 autoloader 的效率，而 Composer 默认生成的 autoload 静态映射（vendor/composer/autoload_classmap.php）体积大、查找慢。启用优化后，Composer 会把所有类路径扁平化为一个紧凑的哈希表，跳过 PSR-4/PSR-0 动态解析，实测加载耗时下降 30%–60%。
关键点在于：--optimize-autoloader（或简写 -o）会触发类映射生成；但仅此不够——你还必须确保没有开发依赖干扰。
- 务必搭配
--no-dev使用，否则 dev-only 包（如phpunit、symfony/var-dumper）也会被扫描进 classmap，徒增体积和无效条目 - 不要用
composer dump-autoload -o单独执行：它只重写 autoload 文件，不清理已安装的 dev 包，classmap 仍含冗余项 - CI/CD 中应始终运行
composer install --no-dev --optimize-autoloader --quiet，避免输出干扰日志
哪些情况会让 --optimize-autoloader 失效或降级
即使加了参数，某些配置或代码结构会让 Composer 自动退回到非 classmap 模式，导致压缩比归零。
-
"autoload": {"classmap": []}为空数组时，Composer 会跳过 classmap 构建 —— 即使你用了-o，最终生成的仍是 PSR-4 映射 - 项目根目录下存在
autoload_files.php或自定义files类型声明，且未被--classmap-authoritative覆盖，会导致 fallback 到动态加载 - 使用了
exclude-from-classmap但路径匹配太宽（如"tests/*"匹配到实际类文件），会剔除本该收录的类，缩小 classmap 反而降低命中率
验证是否生效：检查 vendor/composer/autoload_classmap.php 是否存在且 >50KB（典型 Laravel 应用约 1.2MB），若文件极小（
--classmap-authoritative 是压缩比的终极开关
这个参数告诉 Composer：“所有类都必须在 classmap 中找到，否则就报错，不准 fallback”。它本身不生成 classmap，但强制所有类加载走 classmap 查表，彻底关闭 PSR 解析逻辑，从而榨干最后一点性能。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 必须与
--optimize-autoloader同时使用，单独加无效 - 启用后，任何未被扫描到的类（比如运行时生成的代理类、
eval()加载的代码）会直接Class not found—— 所以只适合完全静态、无反射魔术的项目 - 常见踩坑：Doctrine Proxy、Laravel Octane 的热重载、某些 Mock 工具依赖动态类生成，开启后必崩
示例命令：composer install --no-dev --optimize-autoloader --classmap-authoritative
别忽略 composer.json 里的隐藏影响
classmap 压缩比不仅看命令参数，更取决于 autoload 配置本身是否“干净”。
- 删掉没用的
psr-0声明（Composer 2.x 已废弃），残留字段会拖慢扫描 - 避免
"autoload": {"psr-4": {"App\": "app/"}}和"autoload-dev": {"psr-4": {"Tests\": "tests/"}}中路径重叠（如app/Console/Commands下混着测试类），会导致--no-dev时部分类被意外排除 - 如果项目用 Monorepo，确保
composer.json中autoload只声明当前包需要的路径，别把整个 workspace 都塞进去
运行前执行 composer validate，能提前发现 autoload 配置冲突或格式错误——这类问题不会报错，但会让 classmap 残缺。
类映射的压缩比上限由代码结构决定，不是参数堆砌出来的。最常被忽略的是：--classmap-authoritative 开关一旦启用，就必须保证所有类在构建时 100% 可见，任何动态行为都会立刻暴露。
