答案：Composer提示“Class not autoloadable”通常因命名空间、目录结构或PSR-4配置不一致导致。需检查composer.json中autoload.psr-4是否正确映射命名空间与路径，如"App\": "src/"；确认类文件路径与命名空间匹配，文件名与类名一致且大小写正确；修改后运行composer dump-autoload更新自动加载映射；确保在项目根目录执行命令；通过--verbose或检查vendor/composer/autoload_psr4.php验证类是否被识别。三者一致并重新生成映射即可解决。
当你在使用 Composer 时遇到 "Class ... is not autoloadable" 的提示，尤其是在启用 PSR-4 自动加载的情况下，通常说明 命名空间、目录结构或 composer.json 配置之间存在不一致。下面是一些常见原因和排查方法，帮助你快速定位并修复问题。
1. 检查 composer.json 中的 PSR-4 配置
确保 composer.json 文件中的 autoload.psr-4 配置正确映射了命名空间到目录路径。例如：
{
"autoload": {
"psr-4": {
"App\\": "src/"
}
}
}
上面配置表示：
- 所有以 App\ 开头的类，都应该在 src/ 目录下查找。
- 类 App\User 应该对应文件 src/User.php。
- 类 App\Service\OrderService 应该对应文件 src/Service/OrderService.php。
常见错误包括：
- 命名空间末尾缺少反斜杠（\）
- 目录路径写错，比如写成 Src/ 而实际是小写 src/
- 拼写错误，如 Ap\\ 或 App\ 写成 App\
2. 确保文件路径与命名空间完全匹配
PSR-4 要求文件路径必须严格匹配命名空间结构。检查以下几点：
- 类文件是否放在正确的子目录中？比如 App\Controller\HomeController 必须位于 src/Controller/HomeController.php
- 文件名是否与类名一致？如类叫 HomeController，文件必须是 HomeController.php
- 命名空间声明是否正确？在文件顶部应为：
namespace App\Controller;
注意大小写敏感问题：在 Linux 系统中，Src 和 src 是不同的目录，务必保持一致。
3. 运行 dump-autoload 更新自动加载映射
修改了 composer.json 或新增了类文件后，必须重新生成自动加载映射：
composer dump-autoload
如果是在生产环境不想安装开发依赖，可以加上：
composer dump-autoload --optimize
这会强制 Composer 重新扫描所有 PSR-4 映射并生成新的类映射表。
4. 检查是否在错误的目录运行 Composer
确保你在项目根目录（即包含 composer.json 的目录）执行 composer install 或 dump-autoload。否则 Composer 无法正确读取配置，导致自动加载失败。
你可以通过以下命令确认当前目录是否有正确的 composer.json：
cat composer.json | grep "psr-4" -A 5 -B 1
5. 使用 Class Map 查看类是否被识别
运行以下命令查看某个类是否已被 Composer 识别：
composer dump-autoload --verbose
它会输出正在扫描的文件。你也可以手动检查生成的自动加载文件：
grep "YourClassName" vendor/composer/autoload_psr4.php
如果找不到你的类，说明路径或命名空间配置有问题。
基本上就这些。只要命名空间、文件路径、composer.json 配置三者一致，并执行了 dump-autoload，PSR-4 的自动加载就能正常工作。问题大多出在细节不一致上，耐心核对即可解决。
