Composer 的 PSR-4 自动加载需满足三条件：命名空间前缀以双反斜杠结尾、目录路径为相对于 composer.json 的相对路径、类文件名严格匹配类名且大小写一致；配置后必须执行 composer dump-autoload（推荐加 -o 参数）生成映射文件，否则类将无法加载。
Composer 的 PSR-4 自动加载不是“开箱即用”的魔法，而是靠 composer.json 中 "autoload" 字段的精确配置 + 运行 composer dump-autoload 生成映射文件共同实现的。没执行 dump 操作、命名空间与路径不严格对应、大小写混用，都会导致类找不到。
PSR-4 配置必须满足的三个硬性条件
PSR-4 不是模糊匹配，它对结构有强制约定：
- 命名空间前缀（如
"App\"）必须以双反斜杠结尾，缺了就变成 PSR-0 兼容模式，行为不可控 - 对应的目录路径（如
"src/"）必须是相对于composer.json所在位置的相对路径，不能写成./src/或绝对路径 - 类文件名必须严格匹配类名 +
.php后缀，且大小写完全一致——Linux 下UserController.php里定义class usercontroller会直接失败
composer dump-autoload 不是可选操作
修改 composer.json 中的 autoload 配置后，Composer 不会自动重写 vendor/autoload.php 和生成的 vendor/composer/autoload_psr4.php 映射表。必须手动触发：
composer dump-autoload
开发中建议加 -o 参数启用优化模式（生成静态映射而非运行时扫描）：
composer dump-autoload -o
注意：如果项目已存在 vendor/autoload.php，但类仍报错，优先检查是否漏掉这一步，而不是怀疑路径或命名空间写错。
常见错误现象与定位方法
遇到 Class "AppHttpControllersHomeController" not found 类错误时，按顺序排查：
- 运行
composer show --platform确认当前环境 PHP 版本是否支持你使用的命名空间语法（如 PHP 7.4+ 才支持属性类型声明，但不影响 PSR-4 加载本身） - 检查
vendor/composer/autoload_psr4.php文件，确认"App\"是否真实映射到了正确的路径数组（例如["src/"]），若为空或映射错位，说明配置未生效或路径不存在 - 用
ls -l src/Http/Controllers/确认文件存在且权限可读；再用php -r "var_dump(class_exists('AppHttpControllersHomeController'));"直接测试，绕过框架封装干扰 - 如果使用 symlink（如 Laravel 的
app目录软链到src），确保 symlink 在运行dump-autoload时是有效的，否则 Composer 会跳过该路径
PSR-4 的“规范”二字，本质是要求开发者主动对齐命名空间层级与物理目录结构。一旦中间某一层目录名拼错、多一个空格、少一个反斜杠，Composer 就不会帮你猜——它只做字面匹配。这也是为什么很多问题看似随机，实则全是路径与命名空间之间那几处肉眼难辨的差异。
