composer不处理psr-4映射，仅执行配置；类找不到主因是路径/命名空间不匹配、大小写敏感或目录不存在，需确保value为真实存在的带/路径、key末尾双反斜杠、文件结构严格符合psr-4规则。
Composer 不处理 PSR-4 映射，它只读取并执行你写的 autoload 配置；映射是否生效，取决于你写的路径对不对、文件结构符不符合 PSR-4 规则。
为什么 composer dump-autoload 后类还是找不到
常见错误现象是运行后报 Class not found，但 composer.json 里明明写了 "psr-4"。根本原因通常是路径没对齐：
-
psr-4的 value（路径）必须是相对于项目根目录的**真实存在**的目录，且末尾要带/（如"src/"），不能写成"src"或"./src" - key（命名空间前缀）末尾必须带
，如"App\"，少一个反斜杠会导致自动加载器拼接失败 - 文件实际路径必须严格匹配命名空间小写转换规则：命名空间
AppHttpControllers→ 文件路径src/Http/Controllers/SomeController.php，大小写敏感（尤其在 Linux/macOS）
composer.json 里 psr-4 的 key 和 value 怎么配才不翻车
关键不是“怎么写教程”，而是理解 key 是命名空间前缀，value 是物理路径起点。二者共同定义「从哪个目录开始，按什么命名空间规则找文件」：
- value 必须是项目根目录下的子目录，且该目录存在（
composer install不会帮你创建） - key 中的
是命名空间分隔符，不是路径分隔符；写成"App\": "src/"才正确，"App": "src/"会因转义失效 - 多个映射可以共存，但不能有重叠前缀，比如
"App\"和"AppHttp\"同时存在时，后者会被前者覆盖（因为前缀更短）
示例正确配置：
{
"autoload": {
"psr-4": {
"App\": "src/",
"Tests\": "tests/"
}
}
}
什么时候该用 psr-4 而不是 classmap 或 files
PSR-4 适合标准类库结构，强调命名空间与目录一一对应；一旦你打破这个约定，就容易掉坑里：
- 如果你有一堆函数文件（无命名空间）、或单文件工具类、或需要全局引入的
.php，别硬套 PSR-4，改用"files"数组直接列出 - 如果你的类名和文件名不一致（比如用下划线或驼峰混搭），或者目录结构混乱，
classmap更稳妥——它靠扫描生成映射，不依赖规则 - PSR-4 在开发中支持热加载（改完类名/命名空间立刻生效），但
classmap每次都要dump-autoload；不过生产环境两者性能差异几乎可忽略
执行 composer dump-autoload 后仍不生效的排查点
别急着重装或清缓存，先看这几个地方：
- 检查
vendor/autoload.php是否被正确引入——很多问题其实出在脚本开头漏了require - 运行
composer show -s查看当前 autoload 配置是否被识别（注意是否有 warning 提示路径不存在） - 用
composer dump-autoload -v看详细输出，它会告诉你跳过了哪些目录（比如因为目录不存在） - 确认 PHP 版本兼容性：
psr-4本身无版本限制，但如果你用了 PHP 8.0+ 的新语法而 Composer 运行在旧版 PHP 下，dump-autoload可能静默失败
最常被忽略的是：PSR-4 映射只对 autoload 阶段生效，不会影响 require 或 include 手动加载的文件——它管不了你手写的那一行 require 'xxx.php'。
