Composer自动加载本质是PHP内核驱动的被动响应机制，仅在new、static调用等触发时按需加载；PSR-4路径错配、classmap预加载与--classmap-authoritative的严格性是关键要点。
Composer 本身不提供“懒加载”语义，但它的自动加载机制天然就是按需触发的——类没被 new、没被 static 调用、没被反射读取，就不会加载对应文件。
为什么 new 一个类才加载文件？
PHP 在运行时遇到未定义的类（比如 new AppServicesUserService），会依次触发所有已注册的 autoload 函数；Composer 通过 spl_autoload_register 注册了自己的加载器，该加载器根据类名匹配 psr-4 规则或查 classmap 表，只加载当前需要的那个文件。
- 这个过程完全由 PHP 内核驱动，不是 Composer 主动“扫描”或“预热”
- 没有
new、static::、class_exists($name, true)等触发点，加载器根本不会被调用 - 所以它不是“懒”，是“被动响应”——你不用，它就不动
PSR-4 配置错一个斜杠就失效
常见错误是命名空间前缀和路径没对齐，导致 PHP 找不到文件。例如：
- 配了
"App\": "src/"，但类写的是namespace AppHttpControllers;→ 正确路径应为src/Http/Controllers/UserController.php - 配成
"App\": "src/App/"，实际类文件在src/Http/Controllers/→ PHP 会去查src/App/Http/Controllers/，404 - Windows 下路径分隔符混用（
vs/）在 composer.json 中不影响，但映射逻辑仍以 Unix 风格解析
验证方式：执行 composer dump-autoload -v，看输出里是否列出你的类路径；再用 composer show -p 确认当前项目是否被识别为 root 包。
classmap 不是“懒”，而是“全量预建”
classmap 是唯一需要主动扫描目录生成映射的方式，它不依赖命名空间推导，但也不支持真正的按需——所有被扫描到的 .php 文件里的类，都会被登记进 autoload_classmap.php，哪怕你从不实例化它们。
- 适合场景：
src/helpers.php这种含全局函数的文件、无命名空间的传统类、或 vendor 中稳定不变的第三方库 - 启用方式：在
composer.json的"autoload"下加"classmap": ["src/helpers.php", "vendor/monolog/monolog/src"] - 必须执行
composer dump-autoload -o才生成有效映射；否则每次加载都实时遍历目录，性能更差
--classmap-authoritative 是把双刃剑
加上 --classmap-authoritative（或 -a）后，Composer 完全跳过 PSR-4 fallback 查找，只查 classmap 表——这能提速，但代价是：表里没有的类，直接 Class not found，连路径是否存在都不检查。
- 仅应在生产环境配合
--no-dev和--optimize-autoloader使用 - 开发中新增类后，必须重新跑
composer dump-autoload -o -a，否则新类永远找不到 - 如果你用了
files加载工具函数（如"files": ["src/functions.php"]），这些函数仍会在启动时全部载入，不属于“按需”范畴
真正容易被忽略的点是：autoload 机制只管“类和函数文件”，不管配置、模板、语言包这些资源——它们的加载时机和策略，得靠框架或你自己控制。
