Composer自动加载无法找到ClassA\Tae类的问题求助

云上老周

2026-5-25

排查Class 'ClassA\Tae' not found 错误

从你给出的配置和代码来看，大概率是以下几个常见问题导致的，咱们逐个排查：

文件路径与类名不匹配（PSR-4核心要求）
PSR-4规则要求类名必须和文件名严格对应（大小写敏感，即使Windows系统不区分大小写，也建议严格遵循）。你需要确认：
- 类文件是否放在includes/ClassA/目录下，且文件名为Tae.php（不能是tae.php、Tae.class.php这类变种）
- 打开Tae.php，确认类的命名空间和定义正确：
```
<?php
namespace ClassA;

class Tae {
    public static function init($param1, $param2) {
        // 你的方法实现
    }
}
```
未更新Composer自动加载映射
修改composer.json后，Composer不会自动更新生成的自动加载文件。你需要在项目根目录执行以下命令，刷新自动加载缓存：
```
composer dump-autoload
```
这个命令会重新生成vendor/composer/下的类映射文件，让Composer能找到你的新类。
命名空间声明错误
检查Tae.php开头的namespace语句，必须严格是namespace ClassA;，不能多写子命名空间（比如namespace ClassA\Utils;）或者拼写错误（比如namespace Classa;），否则即使文件路径对了，也会因为命名空间不匹配找不到类。
autoload.php引入路径错误
你的测试文件里用了__DIR__ .'/../vendor/autoload.php'，需要确认这个相对路径是否正确。比如如果你的测试文件在tests/目录，项目根目录下有vendor/和includes/，那这个路径是对的；但如果测试文件的位置不同（比如直接在根目录），那路径就错了。可以临时加一行代码验证：
```
var_dump(file_exists(__DIR__ .'/../vendor/autoload.php')); // 应该返回true
```
如果返回false，调整路径到正确的autoload.php位置即可。