composer生成类映射文件的核心命令是composer dump-autoload --optimize-autoloader，该命令扫描psr-0/psr-4路径生成vendor/composer/autoload_classmap.php静态映射，提升自动加载性能，需配合--no-dev、--apcu-autoloader或--classmap-authoritative等选项按场景使用。
Composer 生成类映射文件（即 autoload_classmap.php）的核心命令是 composer dump-autoload --optimize-autoloader，不是 composer optimize-autoloader —— 后者根本不存在，是常见误传。
为什么 composer optimize-autoloader 会报错
这个命令从未被 Composer 实现过。从 Composer 1.x 到 2.x，官方只提供 dump-autoload 子命令，并通过 --optimize-autoloader（或简写 -o）启用类映射优化。
- 运行
composer optimize-autoloader会直接提示Command "optimize-autoloader" is not defined - 部分旧文档或博客误将选项名当成独立命令，导致混淆
- Composer 2.2+ 起还新增了
--apcu-autoloader，但同样必须配合dump-autoload
dump-autoload --optimize-autoloader 实际做了什么
它会扫描所有 PSR-0/PSR-4 声明的目录，把每个类名到文件路径的映射提前写入 vendor/composer/autoload_classmap.php，跳过运行时遍历目录的开销。
- 仅对
classmap类型和明确声明的 PSR 自动加载路径生效；未在autoload或autoload-dev中声明的文件不会被收录 - 生成的映射是静态的，代码增删类后必须重新执行该命令，否则自动加载失败
- 在生产环境部署时建议加
--no-dev：避免把autoload-dev的映射也打进去，减小体积且更安全 - PHP 7.4+ 下，若启用 APCu，可追加
--apcu-autoloader把映射缓存到共享内存，进一步提速
典型使用场景与推荐命令
日常开发一般不需要频繁执行；真正需要的是部署上线、CI 构建或性能敏感服务启动前。
- 标准生产构建：
composer dump-autoload --optimize-autoloader --no-dev - 带 APCu 缓存（需扩展已启用）：
composer dump-autoload --optimize-autoloader --apcu-autoloader - 仅优化当前项目（不含 vendor）：
composer dump-autoload --optimize-autoloader --classmap-authoritative，此时 Composer 完全信任 classmap，不再 fallback 到文件系统查找——适合 Docker 镜像等不可变环境 - 验证是否生效：检查
vendor/composer/autoload_classmap.php是否非空，且内容为长数组形式（如'Foo\Bar' => __DIR__ . '/..' . '/src/Bar.php'）
类映射本身不解决命名空间拼写错误或文件未声明 namespace 的问题，它只是加速“已知类”的定位。如果 autoload_classmap.php 里没有某个类，那要么没被扫描到，要么压根没被 autoload 配置覆盖——这时候该查的是 composer.json 里的 autoload 字段，而不是反复重跑 dump 命令。
