确认autoload_classmap.php是否生成并生效：检查vendor/composer/autoload_classmap.php是否存在且非空，若为空或过小，说明classmap未全量构建；需排查PSR-4路径末尾反斜杠缺失、tests/误入主autoload、Xdebug干扰或未加--no-dev导致dev类混入。
自动加载变慢，90% 不是代码问题，而是 classmap 没生成、没生效，或被 Xdebug / 错误配置悄悄拖垮。
怎么确认 autoload_classmap.php 是否真生成并起作用
优化是否落地，不能只看命令有没有报错，得查文件本身。运行 composer dump-autoload -o 或 composer install --optimize-autoloader 后，立刻检查：vendor/composer/autoload_classmap.php 是否存在且内容非空。
- 如果文件为空、只有几行或根本不存在：说明优化被跳过——常见原因是项目里
composer.json的 PSR-4 配置末尾缺反斜杠（如写成"App": "src/"而非"App\": "src/"），导致 Composer 放弃扫描该路径 - 如果文件大小明显偏小（比如不到 1KB），但项目有上百个类：说明 classmap 构建不全，大概率漏了
autoload-dev里的路径，或误把tests/加进了主 autoload（应只在autoload-dev中声明） - 用
grep -c '=>' vendor/composer/autoload_classmap.php粗略统计类数量，和实际类数对比；差距大就说明映射断裂
为什么加了 -o 还是慢？先关 Xdebug 和插件
Composer 在 CLI 下启用 Xdebug 后，class_exists()、反射调用、文件遍历等操作会被严重拖慢，autoload 生成阶段可能多花 3–5 倍时间。这不是配置问题，是执行环境干扰。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 运行
php -m | grep xdebug确认是否加载；若存在，临时禁用：php -d zend_extension= -d xdebug.mode=off /usr/bin/composer dump-autoload -o - 插件也会拖累，尤其做静态分析的（如
composer-unused）；加COMPOSER_DISABLE_PLUGINS=1再试 - 别信“我开发机没开 Xdebug”——某些 IDE（如 PHPStorm）会静默注入，用
php -i | grep "xdebug.mode"实锤
怎么定位 autoload 生成卡在哪一步
用 --profile 是最直接的方式，它会打印每一步耗时，暴露真实瓶颈。
- 运行
composer dump-autoload --profile，观察输出中类似[842.3ms] Scanning /path/to/vendor/bad-pkg/src的长耗时项 - 如果大量时间花在
Scanning tests/或Scanning docs/：说明composer.json里误把"tests/": ["tests/"]写进了autoload.classmap，应移至autoload-dev - 对比
composer dump-autoload --profile和composer dump-autoload -o --profile的总耗时：后者应显著更短；如果差不多，说明 -o 实际未触发 classmap 重建（见上一条，大概率是 PSR-4 配置不合法）
classmap-authoritative 开了却报 Class not found 怎么办
--classmap-authoritative（或 -a）不是“加速开关”，而是“信任开关”：它让 autoloader 完全跳过文件存在性检查，类不在 classmap 里就直接报错，不 fallback。
- 报错 ≠ 配置错，而是 classmap 漏类 —— 最常见是命名空间和路径不匹配，例如配置了
"App\": "app/"，但文件里写的是namespace AppHttpControllers;（少了一级\），导致推导路径失败 - 新增类后必须重新运行
composer dump-autoload -o或composer install --optimize-autoloader，否则 classmap 不更新 - 用了
files类型加载（如全局函数文件）不会进 classmap，但--classmap-authoritative不影响它们——这类文件仍会被require_once，只是不参与类查找逻辑
最容易被忽略的一点：很多人在 CI 脚本里写了 --optimize-autoloader，却忘了加 --no-dev，结果把 autoload-dev 里的测试类全塞进生产 classmap，既增大体积又引入无关路径，反而拖慢加载。优化不是加参数，是删干扰。
