require __DIR__.'/../vendor/autoload.php' 是启动Composer自动加载机制的强制开关，它通过 spl_autoload_register() 注册加载器、载入PSR-4等映射表、预加载配置文件，缺一不可；路径错误、命名空间末尾缺反斜杠、未执行 composer dump-autoload 均导致类无法加载。
必须在入口文件中显式引入 vendor/autoload.php，否则 autoload 机制压根不启动——不是类找不到，是根本没注册加载器。
为什么 require_once 'vendor/autoload.php' 是强制动作
这个文件不是“辅助工具”，而是 autoload 引擎的启动开关。它内部做了三件事：spl_autoload_register() 注册全局回调、载入 autoload_psr4.php 等映射表、预加载 files 配置里的函数文件。跳过它，等于没插电源就按开机键。
- Web 入口（如
public/index.php）里写错路径（比如少个..）会导致整个项目 Class not found - CLI 脚本（如
artisan或自定义命令）也得单独require_once，不能依赖 Web 入口上下文 - 框架（如 Laravel）的 public/index.php 里那行
require __DIR__.'/../vendor/autoload.php'少一个/..，上线就白忙
psr-4 的 key 必须以 \ 结尾，否则命名空间解析直接失效
这是 PSR-4 规范硬性要求，不是可选项。Composer 把不带结尾反斜杠的 key 当作完整命名空间名处理，后续拼接类名时会出错。
-
"App\": "src/"✅：表示所有App\*类从src/开始找，App\Http\Controller\Home→src/Http/Controller/Home.php -
"App": "src/"❌：Composer 会尝试加载AppHttpControllerHome，而不是App\Http\Controller\Home - 错误现象典型表现：
Class AppHttpControllersHomeController not found，但文件明明在app/Http/Controllers/HomeController.php
autoload 配置改完后必须手动执行 composer dump-autoload
Composer 不监听 composer.json 变更，也不热重载。配置只是静态文本，不运行命令就不会生成或更新映射文件（如 vendor/composer/autoload_psr4.php）。
- 新增类、移动文件、改 namespace、调整 psr-4 映射，都必须跑一遍
composer dump-autoload - 开发阶段加
-o参数（composer dump-autoload -o）可生成优化版 classmap，但 PSR-4 映射仍走规则匹配，不受影响 - 常见误操作：在子目录（如
src/）下执行该命令，实际应确保当前工作目录是composer.json所在根目录
autoload-dev 不是 autoload 的子集，它必须独立声明且只在 dev 环境生效
autoload-dev 是顶层字段，和 autoload 并列，不是嵌套在 require-dev 里。它的映射只在未加 --no-dev 时注入到 vendor/autoload.php 中。
- PHPUnit 测试类（如
Tests\Unit\UserTest）必须配在autoload-dev下，例如："Tests\": "tests/" - CI 环境若用了
composer install --no-dev，Tests\*命名空间将完全不可用，class_exists('Tests\Unit\UserTest')返回false - 把测试类塞进主
autoload段，会导致生产环境也加载它们，可能触发未安装的 dev-only 依赖
最常被忽略的其实是路径计算逻辑：Composer 所有 autoload 路径都是相对于 composer.json 所在位置，不是项目根、不是 vendor、也不是当前执行脚本位置。大小写、末尾斜杠、命名空间转义，三个点只要错一个，findFile() 就默默返回 false，然后 PHP 抛出标准的 Class not found —— 它不会告诉你哪一步算错了。
