类找不到是因为 composer 启用自动加载优化后仅查静态 classmap，新增类未重新 dump 或路径/命名空间不匹配即失效；临时解决用 composer dump-autoload --no-optimize，开发环境推荐在 composer.json 中设 "optimize-autoloader": false 和 "classmap-authoritative": false。
为什么 composer dump-autoload 后类突然找不到？
因为 Composer 默认启用自动加载优化（--optimize 或 --classmap-authoritative），它会把所有可自动加载的类路径预生成到 vendor/composer/autoload_classmap.php 中，跳过 PSR-4/PSR-0 的动态查找逻辑。一旦你新增了类但没重新 dump，或类文件路径/命名空间和配置不一致，优化后的 classmap 就不会包含它——而调试时又常依赖 IDE 或 class_exists() 动态判断，结果就是“类存在、却报错找不到”。
- 典型现象：
Class "App\Services\MyService" not found，但文件明明在app/Services/MyService.php，且composer.json里已配好 PSR-4 - 触发场景：开发中频繁增删类、用 symlink 挂载模块、或切换 Git 分支后未重刷 autoload
- 根本原因：优化模式下 Composer 不再扫描目录，只查 classmap；而 classmap 是静态快照，不随文件变化实时更新
如何临时禁用自动加载优化？
最直接的办法是加 --no-optimize 参数重新生成 autoload：
composer dump-autoload --no-optimize
这会让 Composer 回退到标准 PSR-4/PSR-0 查找逻辑，每次 new 或 use 时按命名空间映射规则实时定位文件，适合调试阶段快速验证类路径是否正确。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 注意：该参数仅影响本次命令，不影响
composer install或composer update的默认行为 - 如果项目启用了
"classmap-authoritative": true（常见于生产配置），需同时加--no-authoritative - IDE（如 PHPStorm）的代码跳转和补全通常也依赖 classmap，禁用后可能变慢或失效——这是权衡，不是 bug
开发环境推荐的 autoload 配置
与其每次手动加参数，不如在 composer.json 里为开发环境设更宽松的 autoload 行为：
{
"config": {
"optimize-autoloader": false,
"classmap-authoritative": false
}
}
然后执行 composer dump-autoload 即可生效。这样避免遗忘参数，也防止 CI/CD 脚本误用生产配置。
-
"optimize-autoloader": false禁用 classmap 生成（即不生成autoload_classmap.php） -
"classmap-authoritative": false允许 fallback 到 PSR 规则，即使 classmap 里没有也能继续找 - 上线前务必改回
true并重新 dump，否则生产性能会明显下降
调试类找不到时，优先检查这三件事
别急着改配置，先确认基础链路是否断裂：
- 运行
composer show --platform确认 PHP 版本匹配composer.json中的platform.php设置，版本不匹配会导致 autoload 跳过某些目录 - 检查类文件的命名空间是否与目录结构严格一致（比如
App\Services\MyService必须对应app/Services/MyService.php，大小写敏感） - 执行
composer dump-autoload -v（加-v显示详细日志），看输出里是否列出了你的类路径；如果没出现，说明 PSR-4 配置有误或文件权限阻止扫描
