Composer 2.2.4+ 是 PHP 8.2 唯一兼容版本，需配置 platform 锁定 PHP 版本、严格遵循 PSR-4 路径映射、首行引入 vendor/autoload.php 并手动执行 dump-autoload 刷新映射。
PHP 8.2 中 Composer 的自动加载机制本身没有新增语法或配置项，但必须确保整个链路兼容 PHP 8.2 —— 否则哪怕 composer.json 写得再标准，也会在类加载时静默失败或报错。
确认 Composer 版本是否支持 PHP 8.2
Composer 1.x 已完全不可用，它会在解析依赖时直接抛出 ParseError: syntax error, unexpected token "string"。必须使用 Composer 2.2.4 或更高版本（推荐 2.5+）。
- 运行
composer --version查看当前版本；低于 2.2.4 就立刻升级：composer self-update - 若项目中存在
composer.lock，且其中记录了旧版 Composer 生成的依赖，建议先删掉 lock 文件，再执行composer install，避免子依赖被错误锁定为 PHP 7 兼容版 - 检查
platform配置：在composer.json的config段加入"platform": {"php": "8.2"}，强制 Composer 解析器按 PHP 8.2 能力选包
psr-4 映射必须与命名空间和目录结构严格一致
PSR-4 是 PHP 8.2 项目中最常用也最容易出错的 autoload 方式。它不校验文件是否存在，只按规则拼路径；拼错一个字母、少一层目录、大小写不匹配，都会导致 Class not found，且无明确提示。
- 例如配置
"App\": "src/"，那么new AppServicesUserService()必须对应文件src/Services/UserService.php，且该文件内必须声明namespace AppServices; - 注意：Windows 下文件系统不区分大小写，但 Linux 和 macOS 区分——开发在 Windows、部署在 Linux 时，
src/services/userservice.php会加载失败 - 不要在 namespace 中多写反斜杠，如
namespace App\Services;（双反斜杠是字符串转义，不是命名空间分隔符），应写作namespace AppServices;
vendor/autoload.php 必须第一个被 require
这是最常被忽略的执行顺序问题。一旦你在引入 vendor/autoload.php 前就 new 了一个未加载的类，或者 require 了其他提前触发类加载的文件，就会因 autoloader 尚未注册而崩溃。
立即学习“PHP免费学习笔记（深入）”；
-
require_once __DIR__ . '/vendor/autoload.php';必须是脚本中第一行有效的 PHP 执行语句（注释、declare 可以在它前面） - 不能包在
if、function、try或 CLI 参数判断逻辑里；Web 入口和 CLI 脚本要各自独立引入 - 不要误改
vendor/autoload.php—— 它由 Composer 自动生成，手改会被下次dump-autoload覆盖
修改 autoload 后必须手动刷新映射表
Composer 不监听文件变化，也不会自动重扫目录。加了新类、改了 composer.json 的 autoload 段、挪动了文件位置，都必须显式执行命令重建映射。
- 开发阶段用
composer dump-autoload即可；追求性能可加-o（composer dump-autoload -o），生成优化版 classmap，跳过部分路径拼接 - 如果用了
files类型（比如加载全局函数），每次请求都会require对应文件，务必确认这些文件里没有 PHP 8.2 不兼容语法（如已废弃的create_function） - 执行后检查
vendor/composer/autoload_classmap.php是否包含你新加的类路径；若没有，说明扫描没命中——常见原因是路径写错、文件没加.php后缀、或文件权限拒绝读取
真正容易卡住的地方不在配置本身，而在「以为配对了」和「实际路径拼出来不对」之间的微小偏差。PHP 8.2 不会帮你宽容大小写或补路径，它只认字面匹配。调试时直接 echo 出拼接后的完整文件路径，比反复猜更可靠。
