必须通过 require_once 'vendor/autoload.php' 启动自动加载机制，因为它注册 spl_autoload_register 并加载映射文件；手动引入映射文件会漏掉注册逻辑，导致类找不到。
composer autoload 为什么 vendor/autoload.php 不能直接 require_once？
因为 vendor/autoload.php 本身只是引导文件，它不直接定义类，而是加载生成的自动加载映射逻辑（比如 vendor/composer/autoload_classmap.php 或 vendor/composer/autoload_psr4.php）。如果你跳过它、手动 require 映射文件，会漏掉 autoloader 的注册逻辑（如 spl_autoload_register 调用），导致类找不到。
常见错误现象：Class 'FooBar' not found，即使类文件明明在 src/ 下且 composer.json 已配好 PSR-4。
- 必须通过
require_once 'vendor/autoload.php'启动整个 autoload 机制 - 这个文件由
composer install或composer dump-autoload生成，不可手写或修改 - 若项目入口未引入它（比如 CLI 脚本忘了这行），所有依赖和自定义命名空间都会失效
PSR-4 映射里 vendor 目录名和命名空间前缀必须严格对齐
Composer 不校验命名空间是否“合理”，只按你写的字符串做前缀匹配。写错一个字母、多一个反斜杠、大小写不一致，都会让自动加载静默失败。
使用场景：你在 composer.json 中配置：
"autoload": {
"psr-4": {
"MyApp\": "src/"
}
}
那么 src/Http/Client.php 对应的类必须声明为 namespace MyAppHttp; —— 注意是 MyApp，不是 myapp、my-app 或 Myapp。
- Windows 下可能因大小写不敏感“看似能跑”，但部署到 Linux 就报错
- 如果用了子命名空间（如
MyAppConsoleCommand），对应目录结构必须是src/Console/Command/，不能是src/console/command/ - 末尾反斜杠
在 JSON 中必须双写为\，否则 JSON 解析失败，autoload 配置被忽略
classmap 和 files 加载方式的区别与误用风险
classmap 是扫描指定路径下所有 PHP 文件，提取 class、interface、trait 声明并建立路径映射；files 是每次请求都无条件 include 这些文件（常用于函数库）。
性能影响明显：files 列表里的文件在每次请求时都会被载入，不管有没有调用其中的函数；classmap 虽然生成时慢一点，但运行时是 O(1) 查找，比 PSR-4 的目录拼接+文件存在检查更快。
- 不要把整个
src/加进classmap—— 它会和 PSR-4 冲突，且失去命名空间语义约束 -
files只适合纯函数文件（如helpers.php），含class声明会导致重复定义错误 - 执行
composer dump-autoload -o会优化 autoload（生成 classmap 并合并），但不会影响files行为
autoload-dev 里的配置只在 dev 环境生效，但测试文件仍需手动加载
autoload-dev 中的 PSR-4 或 classmap 不会自动进入主 autoloader，只有运行 composer install --dev 或 composer dump-autoload（默认包含 dev）时才生成对应映射。但它不影响运行时行为逻辑 —— 一旦生成，就和主 autoload 一样工作。
容易踩的坑：用 PHPUnit 写测试，类在 tests/ 下，composer.json 里写了：
"autoload-dev": {
"psr-4": {
"Tests\": "tests/"
}
}
但测试运行时报 Class 'TestsTestCase' not found。
- 确认是否执行过
composer dump-autoload（CI 环境常漏掉这步） - PHPUnit 启动时是否也引入了
vendor/autoload.php？有些自定义 bootstrap 忘了这一行 - 别在
autoload-dev里配和主 autoload 冲突的前缀（比如都用App\），否则类加载顺序不确定
dump-autoload，出问题时往往只报“类没找到”，得一层层查配置、查生成文件、查实际命名空间声明。最常被忽略的是：改完 composer.json 后忘记重新 dump，或者在非标准入口里漏掉了 vendor/autoload.php。 
