如何调试 Composer 自动加载器，找出类或文件未被加载的原因？

Composer自动加载失败主因是路径或命名空间配置错误；需验证类名/命名空间/文件路径是否严格一致、composer.json autoload配置是否正确、autoloader是否已更新。

Composer 自动加载失败，通常不是类写错了，而是自动加载配置没覆盖到路径或命名空间。调试核心是验证三件事：类名是否匹配命名空间和文件路径、composer.json 中的 autoload 配置是否正确、以及 autoloader 是否已更新。

检查类名、命名空间与文件路径是否严格一致

Composer PSR-4（最常用）要求：类的完整命名空间 + 类名，必须能一对一映射到磁盘上的文件路径。大小写、斜杠/反斜杠、目录层级都不能出错（尤其在 Linux/macOS 上区分大小写）。

• 比如类 AppServicesUserService，应位于 src/Services/UserService.php（假设 "App\": "src/"）
• 文件名必须是 UserService.php，不能是 userservice.php 或 User_service.php
• 文件开头必须有 namespace AppServices;，且不能多空格、换行或 BOM 字符

验证 composer.json 的 autoload 配置是否生效

打开 composer.json，确认你修改的是正确的 autoload 段（autoload 用于生产，autoload-dev 仅限开发环境）。常见错误包括：

• 把路径写成相对路径如 "src"，但实际项目根目录不在预期位置（应使用从项目根出发的路径）
• 命名空间末尾漏了反斜杠，例如写成 "App": "src/" 是对的，但 "App\" 是错的（PSR-4 规范要求命名空间以 \ 结尾，但 Composer 配置中不加也接受；加了反而可能因转义出问题）
• 混用 PSR-4 和 classmap：如果某个类不在 PSR-4 路径下，又没被 classmap 扫描到，就会找不到

重建并检查自动加载器状态

每次改完 composer.json 或移动文件后，必须重新生成自动加载文件：

标签： composer 自动加载 php linux js json app 工具 mac macos 开发环境 cos 为什