Class 'XXX' not found 错误90%因类名拼写错误、大小写不匹配、autoload未覆盖路径或缓存未更新；需检查类名/文件名一致性、use语句、composer.json映射、dump-autoload及opcache缓存。
静态调用报错 Class 'XXX' not found，90% 是类名拼写错误或自动加载没覆盖到路径，不是 PHP 版本或语法问题。
类名大小写和文件名是否严格匹配
PHP 在 Linux/macOS 下区分类名大小写，也区分文件名大小写。哪怕只错一个字母或大小写不一致，new XXX() 或 XXX::method() 都会触发 Class 'XXX' not found。
- 检查
use语句里的类名：比如写了use App\Models\user;，但实际类是User（首字母大写）→ 错 - 检查
composer.json中的 autoload 配置是否映射了对应命名空间路径 - 确认类文件名是否与类名完全一致：类
HelperTool必须存为HelperTool.php，不能是helper_tool.php或helpertool.php
Composer 自动加载没生效或配置错误
没运行 composer dump-autoload，或 psr-4 映射路径写错，会导致类找不到——即使文件存在、类名正确。
- 检查
composer.json中的"autoload": {"psr-4": {"App\\": "app/"}}是否指向真实目录（注意结尾斜杠和反斜杠差异） - 确保类文件在映射路径下，且命名空间与目录结构一致：例如
App\Models\User必须放在app/Models/User.php - 修改完
composer.json后，必须执行composer dump-autoload -o（加-o生成优化后映射） - 开发中临时测试可加一句
require_once __DIR__ . '/path/to/YourClass.php';，绕过 autoloader 排查是否纯加载问题
静态调用时用了错误的类上下文
写 SomeClass::doSomething() 之前，得先确保 SomeClass 已被加载，且不是在未声明命名空间的文件里误用了带命名空间的类名。
立即学习“PHP免费学习笔记（深入）”；
- 如果在全局命名空间文件中调用
App\Models\User::find(1)，没问题；但如果当前文件有namespace Admin;，又没写use App\Models\User;，就会报错 - 别依赖“之前某个地方 new 过它就自动可用”——静态调用不触发实例化，也不隐式加载
- 用
class_exists('App\Models\User')或get_declared_classes()打印验证类是否真被加载
最常被忽略的是：改了类名或移动了文件后，忘了删 vendor/composer/autoload_classmap.php 里的旧缓存项，或者用的是 APCu/opcache 缓存了旧的 autoloader 映射——这时候清缓存比重写代码更有效。
