PHP类名冲突必须解决，否则触发Fatal error终止脚本；核心解法是用命名空间隔离同名类，并通过use别名或完全限定名调用，确保类查找准确无误。
PHP类名冲突不是“能不能解决”的问题，而是“不解决就直接报错”的硬性限制——Fatal error: Cannot redeclare class 一出现，脚本立刻终止。核心解法只有一条：**用命名空间把同名类隔开，再配合use或完全限定名调用**。
为什么new User()会找不到类或报错
常见错误现象是：类文件已加载、class_exists('User')返回false，或者提示Class 'User' not found。根本原因不是类不存在，而是PHP在当前作用域下按规则查找失败：
- 没声明
namespace，类被注册到全局空间；但你又在命名空间内写new User()，PHP就在当前命名空间下找User，而不是全局的 - 两个
use User;来自不同命名空间，没加as别名，后续直接写User::xxx()时无法分辨该用哪个 - 手动
require了同名类文件，绕过了Composer自动加载，导致类被重复定义（尤其在测试或老项目中）
use必须加as别名的三种典型场景
当同名类必须共存于一个文件时，use不加as等于没写。别名不是可选项，是强制隔离手段：
- 引入两个
Logger类：一个来自MonologLogger，一个来自AppLoggingLogger，必须写成use MonologLogger as MonologLogger;和use AppLoggingLogger as AppLogger; - 调用PHP内置类如
Exception或DateTime时，若当前文件有namespace App;，就不能写new Exception()——它会去找AppException。应写new Exception()或use Exception; - 第三方SDK和你自己写的
HttpClient同名，且都需在同一个Service里用，不别名就只能删掉一个
PSR-4自动加载失效时的快速自检点
明明命名空间和目录结构对得上，class_exists('AppModelsUser')却返回false？重点检查这几处：
立即学习“PHP免费学习笔记（深入）”；
-
composer.json里的autoload配置是否漏了末尾反斜杠："App\": "src/"✅，不是"App": "src/"❌ - 类文件路径是否严格匹配命名空间：类
AppModelsUser必须放在src/Models/User.php，不能是src/models/user.php（大小写敏感） - 执行过
composer dump-autoload吗？修改composer.json后这步不能跳过 - 有没有在某个地方用
require_once 'src/Models/User.php'硬加载？这会破坏PSR-4机制，造成类定义冲突或丢失
最易被忽略的是：**命名空间声明必须是文件第一行有效PHP代码，前面不能有任何输出（包括BOM头、空格、注释）**。一个看不见的UTF-8 BOM就能让整个命名空间失效，而错误提示里完全不会提这事。
