vendor/autoload.php由composer install/update末尾自动生成，仅引入autoload_real.php并调用getloader()，不包含映射逻辑；所有实际路径解析由vendor/composer/下的autoload_psr4.php等文件承担。
composer install 时 vendor/autoload.php 怎么来的
它不是凭空生成的，而是 composer install 执行过程中解析 composer.json 的完整结果之一。这个过程会同时处理两件事：下载依赖包 + 构建自动加载映射。
关键点在于：vendor/autoload.php 本身不存任何映射数据，它只是个“门面”，真正干活的是 vendor/composer/autoload_real.php 和一组 autoload_*.php 文件（如 autoload_psr4.php、autoload_classmap.php）。这些文件在 install 或 update 时被动态写入，路径和内容完全由 composer.json 中的 autoload 配置决定。
- 如果你删掉
vendor/后只运行composer dump-autoload，它不会重建autoload_real.php或依赖包的映射 —— 因为没依赖可解析 -
require块里的包，其自身的autoload配置也会被合并进来，比如monolog/monolog的 PSR-4 映射会和你的项目映射一起写进autoload_psr4.php - 如果某个包用了
classmap方式，它的所有类路径会被扫描并固化进autoload_classmap.php，这类映射是静态的，不随命名空间变化而动态推导
为什么改了 src/ 下的类却无法自动加载
常见现象是：新增了一个 AppServicePaymentService 类，命名空间和路径都对，但 new AppServicePaymentService() 报错 Class 'AppServicePaymentService' not found。
根本原因不是自动加载器坏了，而是映射没更新。Composer 不监听文件系统变化，它只认 composer dump-autoload 这个信号。
- 运行
composer dump-autoload是必须步骤，尤其在开发中频繁增删类时 - 如果用了
--optimize（即生成autoload_classmap.php），它会忽略 PSR-4 的动态推导逻辑，只查 classmap 表 —— 这时即使路径对，没跑dump-autoload就永远找不到新类 - 检查
composer.json里psr-4的键值是否末尾带反斜杠："App\": "src/"是对的，"App": "src/"会导致命名空间解析失败
autoload_files 和 require_once 的区别在哪
files 字段在 composer.json 中声明的 PHP 文件，会在每次自动加载启动时无条件 require_once —— 它不依赖类是否存在，也不走命名空间匹配，就是纯函数加载。
这跟手动在入口文件里写 require_once 'helpers.php' 看似一样，但有本质差异：
-
files加载时机更早，在ClassLoader::register()之前就执行，所以里面定义的函数能被其他自动加载类直接调用 - 它被写进
autoload_files.php，和 PSR-4 映射解耦，哪怕你删掉整个autoload_psr4.php，files还是照常加载 - 注意路径是相对于项目根目录的，不是
vendor/；且不能用通配符，每个文件都得单独列出来
生产环境该不该用 --optimize
应该，但要清楚代价：composer install --optimize-autoloader --no-dev 会强制生成 autoload_classmap.php，把所有 PSR-4 路径转成“类名 → 绝对路径”的静态数组。
好处是跳过字符串解析和目录拼接，加载速度提升明显；坏处是丧失灵活性：
- 新增类后必须重新运行
composer dump-autoload --optimize，否则类不可见 - 如果项目里混用了 PSR-4 和非标准目录结构（比如
src/Models对应AppModels，但部分模型放在legacy/），--optimize可能漏掉那些没被扫描到的文件 - 某些 IDE 或热重载工具（如 Laravel Octane）依赖 PSR-4 的动态行为做反射分析，开启优化后可能失效
真正容易被忽略的是：这个优化开关对依赖包也生效。如果你的某个上游包内部用了 glob() 动态加载配置，而它又恰好被 --optimize 扫进了 classmap，那它的动态逻辑就彻底失效了 —— 这类问题往往要翻包源码才能定位。
