Classmap 为空或仅几行是因 composer.json 中 autoload.classmap 路径未正确配置或不存在；启用 --classmap-authoritative 后仅查表，未收录类会直接报错；PSR-4 前缀应合并精简，生产环境优先用 --optimize-autoloader 而非 classmap。
Classmap 生成后 vendor/autoload_classmap.php 为空或只有几行
这不是 bug，而是配置没生效。Composer 只在 composer.json 的 autoload.classmap 字段里明确写了路径（如 ["src/", "lib/"]），且这些路径真实存在、包含 PHP 文件时，才会扫描并写入映射。路径末尾必须带 / 表示递归扫描；写成 "src" 不会报错但不扫描子目录。执行 composer dump-autoload -v，如果输出里没有 Generating optimized autoload files (using classmap)，说明根本没走 classmap 流程。
启用 --classmap-authoritative 后 Class not found 报错
这个参数不是“加速开关”，而是“强制查表模式”：Autoloader 会跳过所有 file_exists() 和 PSR-4 路径拼接逻辑，只查 autoload_classmap.php。一旦某个类没被收录进 classmap（比如你刚新增的类、测试文件、动态命名空间类），就直接报错。所以它只适合生产环境或 CI，在部署前必须确保：
-
composer.json的classmap配置覆盖全部需加载的类路径 - 执行了
composer install --no-dev --optimize-autoloader --classmap-authoritative - 确认新类已通过
grep -n "YourClass" vendor/composer/autoload_classmap.php找到
PSR-4 映射太多导致首次请求慢
PSR-4 的性能损耗不在“加载”，而在“查找”——Autoloader 按注册顺序逐个比对命名空间前缀。前缀冗余、重叠或数量过多（比如拆成 "AppHttpControllers": "app/Http/Controllers/" 和 "AppHttpMiddleware": "app/Http/Middleware/"）会触发大量字符串匹配和 stat() 系统调用。优化方式很直接：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 合并前缀：
"AppHttp": "app/Http/"一条就够了 - 删掉无用项，比如
"Tests\": "tests/"在生产环境毫无意义 - 避免空前缀 fallback（
"": "src/"），它会让每次类加载都兜底扫描整个目录
autoload_classmap.php 在生产环境反而拖慢响应
别被“预生成=更快”误导。classmap 是全量数组，动辄数 MB，每次请求都要完整 require 或反序列化，而实际只用到其中不到 5% 的类。PHP OPcache 虽能缓存它，但内存占用和解析开销仍高于精简后的 PSR-4 查找表。真正推荐的生产方案是：
- 删掉
autoload.classmap配置（除非 legacy 代码强依赖） - 用
composer install --no-dev --optimize-autoloader，它会把 PSR-4 前缀转为静态哈希表，不生成 classmap - 对极少数高频类，改用
class_alias()或启动时require_once，绕过 autoloader
classmap 不是通用加速器，它是给“结构混乱但稳定不变”的旧代码准备的妥协方案，不是现代项目的默认选择。
