PHP 8.5 无自动加载机制，依赖 Composer 配置 PSR-4 或 classmap 并执行 dump-autoload；require 'vendor/autoload.php' 必须在所有 new 前执行，否则 Class not found。
PHP 8.5 本身不提供自动加载机制，它只定义了 __autoload（已废弃）和 spl_autoload_register() 这两个底层钩子；真正实现类文件自动加载的，是 Composer —— 而且必须配合正确的配置和引入方式，否则哪怕代码写对了也会报 Class not found。
composer init 后必须手动加 autoload 配置
很多老项目执行 composer init 时跳过了 autoload 步骤，结果生成的 composer.json 里 "autoload" 字段为空或根本不存在。这种情况下，vendor/autoload.php 虽然存在，但什么也不会加载。
- 必须显式配置 PSR-4 或 classmap，例如：
{ "autoload": { "psr-4": { "App\": "src/" } } } - 路径末尾的斜杠不能少：
"App\"是命名空间前缀，"src/"是物理目录，缺一不可 - Windows 下路径分隔符不影响，Composer 内部统一转为
/处理 - 改完后一定要运行
composer dump-autoload，否则新配置不生效
PSR-4 和 classmap 的选择逻辑
PSR-4 适合新项目、有规范命名空间的代码；classmap 才是处理老旧 PHP 文件（无命名空间、类名与文件名不一致、class_exists() 动态判断场景）的唯一可靠方案。
- PSR-4 加载靠“推测”：看到
new AppCoreLogger()，就去src/Core/Logger.php找文件 —— 如果实际路径是lib/logger.class.php，直接失败 - classmap 加载靠“穷举”：你指定
"classmap": ["lib/"]，Composer 就会扫描该目录下所有.php文件，用正则提取class X、interface Y，生成硬编码映射表 - classmap 不需要
require或include，也不依赖文件名，但每次增删类都得重新运行composer dump-autoload - 混合使用没问题：
"autoload": {"psr-4": {...}, "classmap": ["legacy/"]}
require 'vendor/autoload.php' 必须在所有 new 前执行
这是最容易被忽略的顺序问题。自动加载器不是“全局注册即生效”，而是把回调函数挂到 SPL 自动加载栈里 —— 如果你在 require 前就写了 new AppCoreLogger()，PHP 会立刻抛出错误，不会等 autoload 注册完再重试。
立即学习“PHP免费学习笔记（深入）”；
- 入口文件（如
index.php或测试文件）第一行就该是：require 'vendor/autoload.php'; - CLI 脚本同理，别在
if (PHP_SAPI === 'cli') { ... }里才 require - PHPUnit 测试中，不要在每个 test 方法里重复 require，应在
tests/bootstrap.php中统一引入 - 如果用了 Workerman 或 Swoole，需确保 worker 进程启动前已加载 autoload，否则子进程里类找不到
真正卡住人的往往不是语法，而是 autoload 的触发时机、扫描范围和路径映射这三者的错位；尤其在从 PHP 7.x 升级到 8.5 后，declare(strict_types=1) 和更严格的类加载顺序会让这些隐性问题集中暴露。
