composer自动加载不是php自动猜路径，而是依赖require 'vendor/autoload.php'注册spl_autoload_register()回调及vendor/composer/autoload_psr4.php静态映射表共同完成；漏引该文件或未执行composer dump-autoload，类必然找不到。
Composer映射加载不是“PHP自动猜路径”，而是靠 vendor/autoload.php 注册的 spl_autoload_register() 回调 + 静态 PHP 映射文件（如 vendor/composer/autoload_psr4.php）共同完成的——漏掉 require 'vendor/autoload.php'，或没跑 composer dump-autoload，类就一定找不到。
为什么 require 'vendor/autoload.php' 是第一道生死线
这行代码是整个自动加载链的起点。它引入了 Composer 自动生成的加载器入口，里面会注册 spl_autoload_register() 并加载映射表。没这行，PHP 根本不会触发任何自动加载逻辑，哪怕类文件、命名空间、路径全对，也直接报 Class not found。
- 常见错误现象：本地开发能跑，部署后报错；CLI 脚本正常，Web 请求失败——大概率是入口文件（如
index.php或artisan）漏了这行 - 不能只在某个子文件里 require：必须在每个执行入口（包括测试脚本、命令行工具、Web 入口）都显式引入
- 不要和
require_once 'vendor/autoload.php'混用多个地方：重复引入可能干扰spl_autoload_register()的注册顺序，导致某些映射失效
PSR-4 映射怎么生成和生效
映射不是运行时动态解析的，而是由 composer dump-autoload 扫描你 composer.json 里配置的路径（如 "App": "app/"），把命名空间到目录的对应关系写死进 vendor/composer/autoload_psr4.php。PHP 加载类时，只查这个数组，不扫描文件系统。
- 命名空间末尾必须带反斜杠
，路径末尾必须带正斜杠/：写成"App": "app"或"App\": "app"都会导致拼接出错，比如变成appController/UserController.php - 类名与文件名必须完全一致（大小写敏感）：Linux 下
UserController.php里定义class usercontroller，或文件叫usercontroller.php，都会失败 - 一个命名空间只能配一个根目录：
"App\": ["app/", "src/app/"]中第二个路径会被 Composer 静默忽略 -
composer dump-autoload不清缓存、不重装包，只重绘这张“地图”——改了类位置或命名空间后，必须手动运行它
为什么改了 composer.json 还是 Class not found
问题几乎总出在映射链中间断开，而不是代码写错了。最常踩的坑是以为改完配置就自动生效，其实 Composer 不监听文件变化。
- 没运行
composer dump-autoload：尤其在 CI/CD 流水线里，如果用了--no-scripts或跳过了 autoload 步骤，vendor/composer/autoload_psr4.php就不存在或内容过期 - 手改了
vendor/composer/autoload_psr4.php：这个文件是生成的，下次dump-autoload会被覆盖，白改 - 路径拼接逻辑被破坏：比如
AppHttpControllersHomeController对应app/Http/Controllers/HomeController.php，但实际文件放在app/Controllers/HomeController.php，映射就查不到 - 命名空间声明漏了
namespace或写错层级：PHP 解析类名时依赖namespace声明，不是靠文件路径反推
映射加载的关键在于“静态性”：它不灵活，但快；不聪明，但可靠。所有问题都指向两个动作是否到位——require 'vendor/autoload.php' 是否执行，composer dump-autoload 是否重跑。其他环节再复杂，也只是在这两点上叠加条件。
