PSR-4 是按需映射而非全量加载，仅在首次使用类时按命名空间规则拼路径、检查并 require_once；类名错误或目录结构不匹配导致 Class not found；真正性能瓶颈是过早实例化重量级对象，非 autoload 本身。
PSR-4 自动加载不是“全量加载”，而是“按需映射”
很多人误以为 composer install 后所有类都会被加载进内存，其实完全不是。Composer 的 PSR-4 配置只是在 vendor/autoload.php 中注册了一组路径映射规则，真正触发文件读取和类定义的，是 PHP 第一次遇到未声明的类名时发生的 class_exists() 或 new 实例化行为。
比如你配置了：
"autoload": {
"psr-4": {
"Monolog\": "src/Monolog/"
}
}
这不会导致 src/Monolog/ 下所有 PHP 文件被 require，只会在代码中首次出现 new MonologLogger() 或 MonologHandlerStreamHandler::class 这类符号时，才按规则拼出路径、检查文件是否存在、然后 require_once 它。
- 映射失败（路径不存在）会抛出
Class not found错误，不是警告 - 同一类只会被加载一次，PHP 内部有类定义缓存，重复 new 不重复 require
- 如果类名拼写错误或命名空间与目录结构不严格对齐（如
FooBarBaz对应src/Foo/Bar/baz.php，但文件名是小写），就会加载失败
延迟实例化依赖项才是性能关键，不是 autoload 本身
PSR-4 加载机制本身开销极小（字符串替换 + file_exists 检查），真正影响首屏或 CLI 命令响应时间的，是过早创建重量级对象：数据库连接、HTTP 客户端、日志处理器等。这些类即使符合 PSR-4，只要没被 new 或静态调用，就不会加载——但一旦构造函数执行，就可能触发网络、磁盘、加密等耗时操作。
典型反模式：
class ReportService
{
private $client;
public function __construct() {
$this->client = new GuzzleHttpClient(); // ⚠️ 构造即实例化
}
}
正确做法是把实例化推迟到真正需要时：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用工厂方法或 setter 注入，而非构造注入
- 使用代理（Proxy）或容器的 lazy-loading 能力（如 Symfony DI 的
lazy: true） - 自己实现简单延迟：把
$this->client设为 null，首次调用getClient()时再 new
composer dump-autoload --optimize 早已过时，别再用
旧版 Composer（--optimize 会生成一个巨大的 vendor/composer/autoload_classmap.php，把所有类路径硬编码进去，绕过 PSR-4 的字符串解析。但它有两个严重问题：
- 破坏开发体验：新增类后必须手动重跑 dump-autoload，否则类找不到
- 实际性能提升微乎其微（现代 PHP 的 opcache 已极大优化 realpath 和 stat）
- 从 Composer 2.0 开始，该选项已被移除；
composer install --optimize-autoloader现在只做 classmap 优化（仅对非 PSR-4 类有效，比如全局函数文件）
现在推荐的做法是：保持 PSR-4，启用 opcache，并确保 opcache.enable_file_override=1 和 opcache.stat=0（生产环境）。
如何验证某个类是否真的被加载了？
靠猜没用，得看运行时行为。最直接的方法是在 vendor/autoload.php 引入前，注册自己的 autoloader 并打日志：
spl_autoload_register(function ($class) {
if (str_starts_with($class, 'App\')) {
error_log("[autoload] {$class}");
}
});
或者更轻量：用 Xdebug 的 xdebug_info() 查看已加载文件，或直接在关键类的 __construct() 里加 echo "Loaded: " . static::class . "
";（仅调试）。
注意：不要在生产环境用 get_included_files() 判断，它返回的是所有已 include 的文件，包括配置、模板等，和 autoload 无关；也不要依赖 IDE 的“跳转到定义”——那只是静态分析，不代表运行时加载。
PSR-4 是地图，不是车队；延迟实例化才是省油的关键动作。很多团队花时间优化 autoload，却让一个 new Redis() 在控制器构造函数里默默拖慢整个请求，这才是最常被忽略的瓶颈点。
