Composer自动加载依赖vendor/autoload.php注册的spl_autoload_register()与预生成的静态映射表协同工作；漏掉require 'vendor/autoload.php'则整个机制失效，直接报Class not found。
Composer自动加载不是“写个函数就能加载类”，而是靠 vendor/autoload.php 注册的 spl_autoload_register() + 预生成的静态映射表协同工作；改了 composer.json 不运行 composer dump-autoload，等于没改。
为什么 require 'vendor/autoload.php' 是第一道生死线
漏掉这行，整个 autoload 机制就彻底失效——PHP 根本不会触发任何自动加载逻辑，直接报 Class not found，哪怕类文件、命名空间、路径全对。
- 入口文件（如
public/index.php）第一行必须是require_once __DIR__.'/../vendor/autoload.php';，不能晚于任何类使用 - 不要自己新建一个
autoload.php放项目根目录再require它——这绕过了 Composer 的 loader 注册和路径缓存机制 - 调试时可加一句
var_dump(class_exists('AppControllerHome'));，如果返回false且确认类存在，大概率就是这一行漏了或路径错了
PSR-4 映射生效的三个硬性条件
PSR-4 不是模糊匹配，是字符串级机械拼接：砍前缀 → 转斜杠 → 拼路径 → 加 .php。任一环节错，文件就找不到。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 命名空间末尾必须带反斜杠：
"App\": "src/"正确，"App": "src/"在新版 Composer 中静默失效 - 路径末尾必须带正斜杠：
"src/"正确，"src"或"src/"（多一个/）都会导致拼出srcControllerHome.php这种非法路径 - 类名与文件名必须严格一致（大小写敏感）：
class UserService必须在UserService.php，Linux 下写成userservice.php直接 404 - 子命名空间必须体现为子目录：
AppModelsUser对应src/Models/User.php，不能压平到src/User.php
composer dump-autoload 到底在做什么
它不是“刷新缓存”，也不是“重读配置”，而是重新扫描你声明的源码路径（如 src/），把所有符合 PSR-4 规则的类名和对应物理路径，硬编码写入 vendor/composer/autoload_psr4.php —— 这个文件才是运行时真正被查的表。
- 新增了
src/Service/Logger.php？不执行composer dump-autoload，映射表里就没有这条记录，必然Class not found - 把
"App\": "src/"改成"App\": "app/"？不执行命令，旧映射仍指向src/，所有类都加载失败 - CI/CD 流水线里跳过这步（比如用了
--no-scripts）？检查vendor/composer/autoload_psr4.php是否存在、内容是否含你的新路径 - 手动改过
autoload_psr4.php？下次dump-autoload会被覆盖，白干
files 和 classmap 的典型误用场景
files 和 classmap 是 PSR-4 的补充，但规则完全不同，混用容易踩坑。
-
files只用于无class声明的纯 PHP 文件（如src/helpers.php），配置后每次引入vendor/autoload.php就会无条件require_once；塞进类文件会触发Cannot declare class X -
classmap是暴力扫描路径下所有.php文件，提取class/interface/trait名字并记录绝对路径；它不依赖命名空间，适合老代码，但新增类后必须重跑dump-autoload - 加载顺序是
classmap→PSR-4→files；如果一个类既在classmap表里又被 PSR-4 匹配到，PSR-4 优先，但classmap里的路径一旦删了文件，表不会自动更新 -
composer dump-autoload -o会强制生成classmap，开发中慎用——改一个类就得重跑，否则本地永远加载不到
最常被忽略的点：PSR-4 映射是静态的、一次生成的，没有任何运行时推导或容错。它不“猜”路径，只查表；而这张表，只在你敲下 composer dump-autoload 的那一刻才被重绘。
