classmap 生成后 autoload.php 仍慢，是因为未在 composer.json 的 autoload 或 autoload-dev 中显式配置 "classmap" 数组，且未执行 composer dump-autoload -o；classmap 需手动指定目录/文件路径并配合 -o 才能生成确定性类名→路径映射，跳过 file_exists() 查找。
classmap 生成后为什么 autoload.php 还是慢？
因为默认的 composer.json 中 "autoload" 没配 "classmap"，或者只写了 "psr-4" —— classmap 不会自动包含所有类，必须显式声明要扫描的目录或文件。
常见错误现象：composer dump-autoload 后 vendor/autoload.php 加载速度没变化，strace 或 Xdebug profiler 显示仍大量 file_exists() 调用。
- 确保在
composer.json的"autoload"和/或"autoload-dev"下添加"classmap"字段 - 值为数组，每个元素是目录路径（如
"src/"）或具体文件路径（如"lib/Helper.php"），不支持通配符 - 运行
composer dump-autoload -o（-o即--optimize），它才会真正生成 classmap 并写入vendor/composer/autoload_classmap.php - 如果项目含大量小文件但命名不规范（比如没遵循 PSR-4），classmap 是唯一能绕过文件系统查找的方案
classmap 和 optimize-autoloader 有什么区别？
--optimize（即 -o）本身不等于启用 classmap：它只是把 PSR-4/PSR-0 映射“扁平化”进一个数组，仍依赖 dirname + basename 拼接路径；而 "classmap" 是直接把类名 → 绝对路径的映射硬编码进去，跳过任何字符串解析和目录遍历。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
composer dump-autoload -o：优化已有 PSR 规则，适合标准结构，但无法覆盖new SomeClass()且无命名空间的场景 -
"classmap": ["src/"]+-o：强制扫描该目录下所有 PHP 文件，提取class、interface、trait声明，生成确定性映射 - 二者可共存：
vendor/autoload.php会按顺序尝试 classmap → PSR-4 → files，所以 classmap 应放在最前 - 注意：classmap 扫描是静态的，新增类后必须重新
dump-autoload，CI/CD 中容易漏掉这步
哪些类适合放进 classmap？
不是越多越好。classmap 文件体积增大，PHP 解析开销会上升；尤其当类极少被实际使用时，预加载反而浪费内存。
立即学习“PHP免费学习笔记（深入）”；
- 高频使用的工具类（如
StringUtils、ArrayHelper） - 框架核心类（非 Composer 包管理的自研 Router、Container 实现）
- 没有命名空间或命名空间混乱的老代码（
class DB、class Model_Base） - 避免将整个
vendor/目录加进 classmap——Composer 包已自带优化 autoload，重复扫描无意义且拖慢dump-autoload - 可配合
composer dump-autoload -a（--classmap-authoritative）告诉 autoloader：“classmap 是唯一真相”，彻底禁用文件系统探测，进一步提速
验证 classmap 是否生效？
别只看执行时间，要看是否真的绕过了 file_exists()。
- 临时在
vendor/composer/ClassLoader.php的findFile()方法开头加echo "find $class\n";，观察输出是否大幅减少 - 检查
vendor/composer/autoload_classmap.php是否存在且非空，里面应有类似'SomeClass' => $vendorDir . '/myproject/src/SomeClass.php'的条目 - 用
php -d opcache.enable=1 -d opcache.enable_cli=1 script.php测试，Opcache 对 classmap 数组的缓存效果更明显 - 线上环境务必关闭
composer.json中的"autoload-dev"，否则 dev classmap 会被加载进来，徒增内存占用
-o、没清 Opcache 缓存，都会让优化完全失效。 
