Composer生成vendor/autoload.php等映射文件而非“autoload文件”，其本身不参与运行时加载；dump-autoload根据composer.json重新生成autoload相关文件，-o启用autoload_static.php提升性能，--classmap-authoritative禁用动态查找。
Composer 不生成“autoload 文件”，而是生成 vendor/autoload.php 这个入口文件和配套的映射逻辑（如 vendor/composer/autoload_classmap.php），它本身不参与运行时加载，只负责初始化自动加载器。
composer dump-autoload 做了什么
执行 composer dump-autoload 会重新扫描 composer.json 中定义的 autoload 配置（psr-4、psr-0、classmap、files），然后生成或更新以下内容：
-
vendor/autoload.php：唯一推荐 require 的入口文件，它只是加载vendor/composer/autoload_real.php并调用ComposerAutoloaderInit{hash}::getLoader() -
vendor/composer/autoload_static.php（PHP 7.4+ 默认启用）：把类名到文件路径的映射提前固化为静态数组，避免运行时解析，提升性能 -
vendor/composer/autoload_classmap.php：仅当配置了"classmap": ["src/"]时生成，是扁平化的['ClassName' => '/full/path/to/file.php']数组 -
vendor/composer/autoload_namespaces.php和autoload_psr4.php：分别对应已废弃的 PSR-0 和主流的 PSR-4 映射规则
注意：dump-autoload 不会重新下载包，也不会检查代码语法；加 -o（optimize）参数才启用 autoload_static.php，加 --classmap-authoritative 则完全禁用动态文件查找，只信 classmap —— 这在生产环境可提速，但要求所有类必须被扫描进 classmap。
PSR-4 加载器怎么找到你的类文件
当你写 new App\\Controller\\HomeController()，Composer 的 PSR-4 加载器按如下逻辑定位文件：
- 查
composer.json中"psr-4": {"App\\": "src/"} - 把命名空间前缀
App\\替换为空，剩下Controller\\HomeController - 将
\\替换为/，得到相对路径Controller/HomeController.php - 拼上根目录
src/→ 完整路径为src/Controller/HomeController.php - 最后执行
require_once（如果文件存在）
这个过程发生在第一次访问该类时，且只做一次。如果 src/ 下没有 Controller/HomeController.php，就彻底失败，不会 fallback 到其他路径 —— PSR-4 是严格前缀匹配，不支持“模糊查找”。
为什么 new 一个类却没报错，但实际没加载成功
常见于以下情况，表面无报错，实则自动加载失效：
- 类文件命名不符合 PSR-4 规范：比如类叫
HomeController，但文件名写成homecontroller.php或HomeController.class.php（必须是HomeController.php） - 命名空间声明错误：文件顶部写了
namespace App\Controller;，但composer.json里配的是"App\\": "app/"，路径对不上 - 未执行
composer dump-autoload：修改了composer.jsonautoload 配置或新增了类，但忘了刷新映射 - 使用了
--classmap-authoritative但没跑composer dump-autoload -o：classmap 没更新，新类永远找不到 - 文件权限或 SELinux 限制导致
require_once静默失败（尤其在容器或 CI 环境）
调试建议：临时在 vendor/composer/ClassLoader.php 的 findFile() 方法里加 var_dump($file)，看它到底想 require 哪个路径。
autoload_static.php 为什么比 autoload_files.php 快
autoload_static.php 是纯 PHP 数组，PHP 解析后直接存入内存；而传统方式（如 autoload_files.php）需在每次 autoloader 触发时动态遍历多个映射表、做字符串替换、拼路径、再 file_exists() 检查 —— 这些都是 I/O 和 CPU 开销。
关键差异：
-
autoload_static.php：所有类→路径映射在脚本启动时一次性载入，查找是 O(1) 数组键查询 -
autoload_psr4.php：每次需循环匹配前缀 + 字符串处理 +file_exists()，最坏 O(n) 且含 I/O
不过 autoload_static.php 有个硬伤：它无法响应运行时动态生成的类（比如 AOP 注入、代理类），也不支持 symlink 路径变更后自动刷新 —— 所以开发阶段通常关掉它（不加 -o），上线再开。
真正容易被忽略的是：Composer 自动加载机制从不解析 PHP 文件内容，它只依赖文件路径与命名空间的约定。哪怕你在 HomeController.php 里删掉 class HomeController，只要路径对得上，require_once 就会执行，只是后续实例化时报 Class 'App\\Controller\\HomeController' not found —— 错误发生在 PHP 解析阶段，不是 Composer 的事。
