最快速有效的验证方式是直接运行 composer dump-autoload 并检查类是否可实例化；Composer 安装后不会自动重生成 autoload 映射，修改 autoload 或 autoload-dev 配置后必须手动执行该命令。
直接运行 composer dump-autoload 并检查类是否可实例化，是最快速有效的验证方式。Composer 安装完成后不会自动触发 autoload 重生成（尤其在修改了 autoload 或 autoload-dev 配置后），不手动刷新，新类就永远“看不见”。
为什么 composer install 后类还是找不到？
常见错误现象：Class 'AppServicesMyService' not found，但文件明明在 src/Services/MyService.php；或测试里 new TestsUnitExampleTest() 报错，而 tests/ 已写进 autoload-dev。
-
composer install只负责下载和解压包，不重新生成自动加载映射（除非首次安装且无vendor/autoload.php） - 修改过
composer.json中的autoload或autoload-dev字段后，必须显式运行composer dump-autoload - 如果用了
psr-4映射，确保命名空间与目录结构严格一致：比如"App\": "src/"要求src/Services/MyService.php的 namespace 是AppServices，少一个反斜杠或大小写错都失败 - Windows 用户注意路径分隔符不影响 autoload，但文件名大小写敏感性可能被忽略——
MyService.php≠myservice.php，Linux/macOS 下直接报错
composer dump-autoload 的关键参数怎么选？
默认行为只处理 autoload（生产环境类），但开发中常需要同时加载测试代码，这时必须加参数。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
composer dump-autoload：仅生成生产 autoload 映射，tests/不包含在内 -
composer dump-autoload --dev：强制包含autoload-dev配置，本地跑测试前必加 -
composer dump-autoload -o（optimize）：生成静态映射表，提升加载速度，适合 CI 或生产构建，但会忽略动态 require（如files类型） -
composer dump-autoload --classmap-authoritative：配合-o使用，告诉 autoloader “类一定在 classmap 里”，跳过文件系统扫描——若漏掉某个类（比如没执行dump-autoload就改了文件），会静默失败
验证是否真生效：三步快速确认
别只信命令没报错，要实际触发加载逻辑。
- 用
php -r "require 'vendor/autoload.php'; var_dump(class_exists('AppServicesMyService'));"直接测试类存在性 - 检查
vendor/composer/autoload_psr4.php是否包含你期望的命名空间映射（例如'App\' => array($baseDir . '/src')） - 运行一个最简测试：
php -r "include 'vendor/autoload.php'; new AppServicesMyService();"，捕获致命错误比查配置更直接 - CI 环境中建议把
composer dump-autoload --dev写进脚本开头，避免因缓存导致某次构建漏掉这步
最容易被忽略的是：autoload 配置改了但没重新 dump，或者误以为 composer update 会顺带刷新映射——它不会。只要动过 autoload 相关字段，dump-autoload 就是不可跳过的一步。
