PHP类自动加载异常求助：MVC项目中类无法被识别

核心问题 #

编辑器有代码提示但运行时报Class "MVC\Router" not found，是因为IDE仅识别了代码中的命名空间注释，但PHP运行时依赖Composer生成的自动加载映射，两者未匹配导致。

分步解决方案 #

1. 检查Router类的命名空间与文件名
   确保Router.php中的命名空间和类名严格对应，且文件名与类名一致（注意大小写，跨平台环境必须严格匹配）：

   <?php
   namespace MVC;
   
   class Router {
       // 类逻辑代码
   }
   

2. 修正composer.json的自动加载配置
   根据你的项目结构选择对应配置：

   • 如果Router.php放在根目录（当前结构）：

     {
         "autoload": {
             "psr-4": {
                 "MVC\\": "./"
             }
         }
     }
     

   • 更规范的做法是将所有业务类移到src目录，然后配置：

     {
         "autoload": {
             "psr-4": {
                 "MVC\\": "src/"
             }
         }
     }
     

3. 重新生成自动加载映射文件
   在项目根目录执行命令，更新Composer的类映射：

   composer dump-autoload
   

4. 确保index.php正确引入autoload文件
   在public/index.php最顶部引入vendor目录下的自动加载文件，注意路径层级（index.php在public目录，需回退到根目录）：

   <?php
   require_once __DIR__ . '/../vendor/autoload.php';
   
   use MVC\Router;
   
   $router = new Router();
   

额外排查点 #

• 确认composer dump-autoload/composer install执行无报错
• 检查文件名大小写：比如Router.php不能写成router.php（Composer自动加载区分大小写）
• 验证vendor/autoload.php文件是否存在

内容的提问来源于stack exchange，提问作者user19574730