require 'vendor/autoload.php' 必须放在入口文件第一行，否则PHP会因autoload队列为空而抛出Class not found错误；PSR-4映射需严格匹配命名空间与路径格式，提速关键在于启用classmap、禁用冗余autoload回调。
require 'vendor/autoload.php' 必须放在入口文件第一行
不是“建议”，是硬性要求。只要它前面出现任何 new、class_exists()、use 或函数调用，PHP 就会立刻触发 autoload 队列——而此时队列还是空的，直接抛出 Class not found 错误。
常见踩坑点：
- 在
if或try/catch里包裹require 'vendor/autoload.php'：PHP 解析到new就查 autoload，根本没进作用域 - CLI 脚本和 Web 入口（如
public/index.php）各自独立，必须分别显式require - 用
include替代require：路径错误时不报错，静默失败，排查成本翻倍
PSR-4 映射表不更新，改了 composer.json 也没用
你改的是配置源，不是运行时数据。映射表存在 vendor/composer/autoload_psr4.php 里，它只在执行 composer dump-autoload 后生成。
关键校验步骤：
- 确认
composer.json中"psr-4"的命名空间以反斜杠结尾："app\"✅，"app"❌ - 路径末尾带正斜杠：
"app/"✅，"app"❌（否则拼成appController/Home.php） - 检查
vendor/composer/autoload_psr4.php是否真有'app\' => ['app/'] - 验证类文件路径与命名空间严格对应：比如
app/controller/Index.php必须声明namespace app\controller;（注意大小写、双反斜杠、层级）
为什么 PSR-4 查找慢？本质是反复 is_file() 磁盘 I/O
ThinkPHP 5.1 等框架自动加载慢，不是类多，而是每次 new 或 class_exists() 都要拼路径 + 调 is_file() 判断，频繁触发磁盘读取。
真正提速靠 classmap —— 它把类名直接映射到绝对路径，查数组即可，零 I/O：
- 只对结构固化、极少新增的目录启用：
"app/common/"、"app/exception/"、"library/" - 绝对不要加
"app/"或"app/controller/"：每次改控制器都要全量扫描，部署变慢 - 配合
composer dump-autoload -o --classmap-authoritative，强制跳过 PSR-4 动态查找
禁用 Error 初始化器和插件自动加载能省掉不少开销
某些框架或插件会在 autoload 注册前就初始化错误处理器（如 set_error_handler），或通过 Composer 插件注册额外 autoload 回调——这些都会拖慢首次加载。
实操建议：
- 关闭非必要插件：检查
composer.json的"extra"或"plugins"字段，移除未使用的 autoload 相关插件 - 延迟初始化 Error 处理器：确保它在
require 'vendor/autoload.php'之后才注册 - 禁用 Composer 默认的
files加载（如有）：这类全局函数文件每次请求都加载，无法缓存
PSR-4 本身不慢，慢的是默认配置下无脑拼路径 + 每次都查磁盘。跳过动态查找、用 classmap 查表、砍掉冗余 autoload 回调，才是真实有效的提速路径。
