正确命令是 composer dump-autoload，配合 -o（--optimize-autoloader）和 --classmap-authoritative 参数用于生产环境；classmap 仅扫描 composer.json 中明确配置的路径，不自动递归全项目，且启用 authoritative 模式后加载器不再回退查找，需严格保证类名与文件结构一致。
classmap 生成命令到底该用哪个
根本不存在 composer optimize-autoloader 这个命令，这是高频误传。正确命令只有 composer dump-autoload，配合参数启用优化逻辑。
日常开发几乎不需要它；真正该用的场景是部署上线、CI 构建、Docker 镜像打包前——此时项目结构已冻结，类文件不再变动。
-
composer dump-autoload --optimize-autoloader（简写-o）：扫描所有 PSR-4/PSR-0 和显式配置的classmap路径，生成扁平化映射表到vendor/composer/autoload_classmap.php -
composer dump-autoload --classmap-authoritative：在生成 classmap 的基础上，强制自动加载器跳过所有 fallback 查找（包括 PSR-4），只查这张表 - 两个参数可叠加：
composer dump-autoload -o --classmap-authoritative --no-dev，这是生产环境推荐组合
为什么加了 classmap 配置却没生效
最常见原因不是命令没跑，而是路径配置或扫描范围出问题。Composer 只扫描 composer.json 中 autoload.classmap（或 autoload-dev.classmap）明确列出的路径，不会自动扫全项目。
- 路径必须相对于
composer.json所在目录；写成"lib/"和"lib"效果不同："lib"会被当作文件名尝试读取，报错Could not scan for classes - 目录末尾加不加
/都行，但"lib/"表示递归扫描，"lib/Helper.php"表示只加载单个文件 - 路径若不存在，
dump-autoload不报错也不警告，只是静默跳过——容易误以为“配了等于生效” - 确认是否执行了命令：新增类后必须手动重跑
composer dump-autoload，classmap 不监听文件变化
--classmap-authoritative 的真实代价
它让 new MyClass() 或 class_exists('MyClass') 直接查数组，省掉 2~5 次 file_exists() 系统调用，性能提升明显。但代价是自动加载器变得“非容错”。
- 类名拼错、运行时动态构造类名（如
Yii::createObject(['class' => $className])）、或依赖class_exists()返回false做分支判断的逻辑，都会失效或抛出更模糊的异常（比如Invalid Configuration） - 开发环境绝对不要开这个参数：改一个类名就得重跑
dump-autoload，打断编码节奏 - CI/CD 流水线里必须固化这步，否则线上镜像可能还在用未优化的 PSR-4 加载器
- 启用后，
vendor/composer/autoload_classmap.php可能为空——这是正常行为，因为权威模式会把映射合并进autoload_static.php或autoload_files.php
验证 classmap 是否真被用了
别只看命令有没有报错，得验证实际加载行为是否走 classmap 路径。
- 检查
vendor/composer/autoload_classmap.php是否非空且含预期类名（如'App\Controller\Home' => __DIR__ . '/..' . '/app/Controller/Home.php'） - 临时删掉 vendor 下某个 PSR-4 映射的目录（比如
src/），再php -r 'new AppControllerHome();'—— 如果仍能成功实例化，说明 classmap 已覆盖该类 - 在代码中加
var_dump($loader->getLoaders());（$loader是vendor/autoload.php返回的对象），观察是否只剩 classmap 加载器，或 PSR-4 加载器是否被禁用 - 注意大小写：Linux 下
MyClass.php里定义class myclass，classmap 会登记失败，开发机不报错，上线就找不到类
classmap 不是银弹，它是为稳定、高频、路径固定的类服务的兜底机制；一旦开了 authoritative 模式，你就得对类名和文件结构负全责——这点比任何参数都关键。
