Composer配置psr-4自动加载提示找不到app\Email类如何排查解决

核心报错原因 #

报错来自两处不符合PSR-4加载规则的写法，和composer.json里的目录映射写法无关：

1. 命名空间大小写不匹配：composer.json中配置的命名空间前缀为App\（首字母大写），但index.php中实例化类时使用的是小写开头的app\，PHP命名空间匹配大小写严格敏感，直接导致加载规则匹配失败。
2. 类文件缺少对应命名空间声明：app/目录下的类文件未声明与配置匹配的命名空间，自动加载器无法定位到对应类。

修复步骤 #

• 给app/目录下的类文件添加正确的命名空间声明
  打开app/Email.php，在文件开头、所有业务逻辑前声明命名空间：

  <?php
  namespace App;
  
  class Email
  {
      // 原有类逻辑保持不变
  }
  

  同理在app/Person.php开头添加相同的命名空间声明，确保文件名和类名大小写完全一致（当前你的文件名Email.php/Person.php和类名匹配，无需修改）。
• 修正index.php中的命名空间写法
  将实例化类时的小写命名空间前缀改为大写，和composer.json配置保持严格一致：

  <?php
  require_once "vendor/autoload.php";
  
  $email = new App\Email();
  $person = new App\Person();
  

• 保持composer.json现有autoload配置即可，"App\\": "app/"的写法完全符合PSR-4规范，不需要修改为./app、/app/等其他形式。
• 进入项目根目录（composer.json所在目录）重新执行自动加载重载命令：

  composer dump-autoload
  

注意事项 #

PSR-4加载规则对命名空间、类名、目录名、文件名的大小写匹配要求严格，即使是Windows系统（文件路径大小写不敏感），PHP层面的命名空间匹配依然区分大小写，所有涉及命名空间的书写必须保持全项目统一。

内容的提问来源于stack exchange，提问作者Dũng Nguyễn Văn