Class not found 错误通常因Composer自动加载失败导致，需检查类命名空间与文件路径是否匹配，确认composer.json中psr-4配置正确，执行composer dump-autoload更新自动加载映射，并验证文件存在及类名拼写无误。

出现 Class not found 错误通常是因为 Composer 无法自动加载你尝试使用的类。这个问题虽然常见，但解决起来并不复杂，关键是要理清自动加载机制和项目结构。

检查类命名与命名空间是否匹配

Composer 使用 PSR-4 或 PSR-0 标准自动加载类文件，这意味着类的命名空间和文件路径必须严格对应。

- 确保类文件中的命名空间（namespace）与你在代码中调用的位置一致。 - 文件路径要与命名空间层级对应。例如：
namespace AppUtils; 应该放在 src/Utils/YourClass.php

确认 composer.json 中的 autoload 配置正确

查看项目的 composer.json 文件，确保 autoload 设置正确指向你的源码目录。

linux-performance-analyzer

Linux 性能分析与调优专家，覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景：系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。

下载

- 常见配置示例：

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

- 修改后必须重新生成自动加载映射

重新生成自动加载文件

即使修改了类或命名空间，Composer 不会自动更新加载器，需要手动执行命令。

- 运行以下命令刷新自动加载：

composer dump-autoload

- 如果添加了新类或调整了结构，建议加上优化选项：

composer dump-autoload --optimize

检查文件是否存在且类名拼写正确

有时候错误只是因为手误或文件没保存。

- 确认类文件确实存在于预期路径 - 检查类名是否和文件名完全一致（包括大小写） - PHP 对大小写不敏感，但文件系统（如 Linux）可能敏感

基本上就这些。只要命名空间、路径、配置和自动加载都对得上，Class not found 错误基本都能解决。