vendor/autoload.php是composer命令生成的引导入口，仅引入autoload_real.php并调用getloader()注册加载器；真正映射逻辑由dump-autoload扫描composer.json和源码后硬编码生成autoload_psr4.php等静态数组文件。
Composer 生成的自动加载文件不是“写出来的”，而是根据 composer.json 配置扫描源码、硬编码映射关系后，直接输出 PHP 数组文件——它不解析代码，只做路径推导和字符串拼接。
vendor/autoload.php 是怎么来的？
vendor/autoload.php 是 Composer 命令（如 composer install 或 composer update）执行时自动生成的入口文件，它本身不包含任何类路径逻辑，只做一件事：引入 vendor/composer/autoload_real.php 并调用 ComposerAutoloadClassLoader::getLoader()。
这个过程不可跳过、不可手写替代：
- 你删掉
vendor/autoload.php后再运行composer install，它会立刻重建 - 手动复制一个别人项目的
autoload.php过来，大概率报错——因为里面引用的autoload_psr4.php等路径是相对生成时环境硬写的 - 它不读取
composer.json运行时，只加载 vendor/composer/ 下已生成的 PHP 映射表
PSR-4 映射表（如 autoload_psr4.php）怎么生成的？
真正决定“new AppControllerHome 到底去哪找文件”的，是 vendor/composer/autoload_psr4.php 这类文件。它的内容就是一个 PHP 数组，比如：
$vendorDir = dirname(dirname(__FILE__));
$baseDir = dirname($vendorDir);
return array(
'App\' => array($baseDir . '/src/'),
);
这个数组不是 Composer 运行时动态计算的，而是在执行 composer dump-autoload 时，由以下步骤一次性生成：
- 读取
composer.json中"autoload": {"psr-4": {"App\": "src/"}} - 扫描
src/目录下所有.php文件（递归，但不进vendor/） - 对每个文件，提取其
namespace声明（靠正则匹配，不实际 require） - 判断该 namespace 是否以
"App\"开头；若是，就记录这个前缀 → 路径映射关系 - 最终把所有匹配到的前缀（去重后）写成静态数组，存为
autoload_psr4.php
注意：它不验证类是否存在、不检查文件名是否匹配类名、不运行任何用户代码——只是字符串匹配 + 路径拼接。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
为什么改了类文件或命名空间，必须跑 composer dump-autoload？
因为映射表是静态快照，不是实时监听器。常见误操作包括：
- 在
src/Service/Logger.php新增一个类，但没运行dump-autoload→autoload_psr4.php里压根没有"App\Service\"这条映射，new AppServiceLogger必然失败 - 把
namespace AppController;改成namespace AppHttpController;，但映射仍为"App\": "src/"→ 匹配不上，也不会 fallback 到 classmap（除非你额外配了） - 移动文件从
src/到app/，但composer.json没同步改路径 → 扫描还是扫src/，新位置被忽略
执行 composer dump-autoload 的本质，就是重新跑一遍上面的扫描+生成流程，覆盖旧映射表。
classmap 和 PSR-4 共存时，谁先被查？
Composer 的 ClassLoader 内部有明确优先级：先 PSR-4 前缀匹配，再 fallback 到 classmap 全局查表。
这意味着：
- 如果一个类同时满足 PSR-4 规则（比如
AppServiceLogger在app/Service/Logger.php，且"App\": "app/"已配置），那 classmap 里哪怕也有同名类，也永远不会被用到 - classmap 是暴力扫描结果，它把每个
.php文件里声明的class/interface/trait名字全提出来，记成["Logger" => "/abs/path/app/Service/Logger.php"]—— 它不关心命名空间，也不校验文件名 - 一旦你删了某个 classmap 文件，但没重新
dump-autoload，classmap 表里还留着旧路径，include时直接failed to open stream
所以 classmap 更适合放那些不遵循 PSR-4 的遗留代码，或者想绕过路径推导提升加载速度（加 -o 参数生成优化版 classmap），但它不是“兜底方案”，而是独立并行的加载通道。
最常被忽略的一点：autoload 文件生成后，ClassLoader 会缓存前缀匹配结果，但不会缓存文件是否存在。也就是说，即使你删了 src/Controller/Home.php，只要映射表里还有 "App\": "src/"，PHP 仍会尝试 include 'src/Controller/Home.php' —— 报错信息是 No such file，而不是 Class not found。这说明问题出在路径拼接环节，而非自动加载机制本身没注册。
