Class not found最常因跨命名空间调用时自动加载未配对、use语句错误或命名空间与物理路径不一致所致，需严格校验PSR-4映射、use写法（含反斜杠）、大小写及执行composer dump-autoload。
跨命名空间调用时类找不到的常见原因
最常遇到的是 Class not found，不是因为你写错了类名，而是自动加载没配对、use 没写对，或者命名空间路径和文件物理路径不一致。PHP 不会自动扫描目录找类，全靠 Composer 的 PSR-4 映射或手动 require。
- 文件实际路径是
src/Models/User.php，但声明了namespace AppEntities;→ 自动加载器找不到 - 在
AppControllers下写了use ModelsUser;，但没加反斜杠 → PHP 当成相对命名空间AppControllersModelsUser - 用了
use但拼错类名，比如use AppModelsUsr;→ 运行时报Class 'AppModelsUsr' not found - 忘记在文件顶部声明
namespace，又没用全局命名空间引用 → 类被放进，而你试图用AppModelsUser调用
use 语句必须写对，尤其注意反斜杠
use 是当前文件的“快捷方式”，不是全局注册。它只影响本文件内不带前缀的类名调用，且默认是相对当前命名空间解析的 —— 这点最容易踩坑。
- 想用全局命名空间的
DateTime，必须写use DateTime;或直接写DateTime - 当前在
AppServices，要导入AppModelsPost，应写use AppModelsPost;，不是use ModelsPost; - 两个同名类冲突（比如
AppModelsUser和VendorLibUser），用别名：use AppModelsUser as AppUser;、use VendorLibUser as LibUser; -
use不能用于动态类名，$class = 'AppModelsUser'; new $class();仍需完整命名空间字符串
PSR-4 自动加载配置必须严格匹配路径
Composer 的 psr-4 规则不是“尽量匹配”，而是“必须精确映射”。哪怕多一个空格、大小写不一致、目录名拼错，都会导致类加载失败。
-
"App\": "src/"表示：所有以App开头的类，都从src/目录下按子目录结构查找 -
AppModelsUser→ 对应文件路径必须是src/Models/User.php，不能是src/models/user.php（Linux 下大小写敏感） - 修改
composer.json后，必须运行composer dump-autoload，否则新规则不生效 - 如果类不在
src/下（比如放在lib/），就得额外加一条映射："Vendor\Lib\": "lib/"
运行时动态调用跨命名空间类的注意事项
用 class_exists() 或 new $fqcn 时，传入的必须是**完全限定类名（FQCN）**，也就是带反斜杠开头的字符串，且不能依赖 use。
立即学习“PHP免费学习笔记（深入）”；
-
class_exists('AppModelsUser')❌ 错误：这是非限定名，PHP 会尝试在当前命名空间下找 -
class_exists('App\Models\User')✅ 正确（双反斜杠转义） -
class_exists(AppModelsUser::class)✅ 更推荐，编译期确定，无字符串拼接风险 - 反射或 DI 容器中传类名，同样要求 FQCN 字符串，例如
$container->get('App\Services\Mailer') - 别用
__NAMESPACE__ . 'SomeClass'拼接，容易在嵌套命名空间里出错；优先用static::class或self::class获取当前上下文类名
use 写法、PSR-4 配置、运行时字符串格式 —— 少一个环节，就会卡在 Class not found 上。最隐蔽的问题往往出在大小写或 Composer 缓存没刷新。 
