Composer自动加载依赖vendor/autoload.php注册spl_autoload_register()及预生成映射表；未require或未dump-autoload则类必找不到，PSR-4路径与命名空间须严格匹配反斜杠和正斜杠。
Composer 自动加载不是“PHP 自己猜路径”，而是靠 vendor/autoload.php 注册 spl_autoload_register() + 预生成的静态映射表（如 vendor/composer/autoload_psr4.php）协同工作；漏掉 require 'vendor/autoload.php' 或没跑 composer dump-autoload，类就一定找不到。
require 'vendor/autoload.php' 必须放在第一行？为什么不能包在 if 或函数里
这行代码不加载类，只做一件事：调用 ClassLoader::getLoader()，把 PSR-4、classmap、files 三类加载逻辑通过 spl_autoload_register() 挂进 PHP 的 autoload 队列。PHP 在解析到 new AppController() 或 use App\Controller\Home 时会立刻触发 autoload，此时队列为空就直接报 Class not found，不重试。
- 入口文件里先
new再require→ 必定失败 - 写成
if (true) { require 'vendor/autoload.php'; }→ 无效，作用域未进入，注册未发生 - CLI 脚本和 Web 入口（如
public/index.php）必须各自显式require，它们不共享 autoload 状态 - 用
include替代require是隐形炸弹：路径错时不报错，只静默失败
PSR-4 映射表从哪来？改了 composer.json 为啥还不生效
映射数据不在 vendor/autoload.php 里，而在 vendor/composer/autoload_psr4.php 这类生成文件中——它就是一个硬编码的 PHP 数组，比如：['App' => ['src/']]。Composer 不监听文件变化，只在你执行 composer dump-autoload 时，扫描 composer.json 中的 autoload.psr-4 字段，重新生成这张表。
-
"App": "src/"→ 命名空间缺反斜杠，App不被识别为有效前缀，跳过 PSR-4 查找 -
"App\": "src"→ 路径缺正斜杠，拼出srcController/Home.php而非src/Controller/Home.php，404 - 改了
composer.json却没跑composer dump-autoload→ 配置只是源，运行时仍用旧映射表 - 手动编辑过
vendor/composer/autoload_psr4.php？下次dump-autoload会被覆盖
镜像源和自动加载有关系吗？
没有直接关系。镜像源（如阿里云、腾讯云 Composer 镜像）只影响 composer install 或 update 时下载包的速度和稳定性，不影响自动加载机制本身。但间接影响很大：
- 镜像源配置错误或失效 →
composer install失败 →vendor/目录缺失或不全 →vendor/autoload.php不存在或损坏 - 私有包未正确配置镜像或认证 → 包没拉下来 → 对应的 PSR-4 映射不会写入
autoload_psr4.php - 镜像同步滞后（如新版本包未及时同步）→
composer require xxx安装了旧版 → 类路径与你代码里写的命名空间不匹配
真正决定类能不能加载的，是 vendor/autoload.php 是否存在且被执行、vendor/composer/autoload_*.php 是否完整、以及你的命名空间和路径是否严格符合 PSR-4 的字符串截取规则——这些环节里，任何一个 / 或 \ 写错，都会让整个链路静默失败。
