命名空间不匹配会导致Class not found错误，因PHP不自动补全命名空间；类文件必须声明正确namespace，use仅影响引用写法，new按完整命名空间查找；trait/interface规则与class一致；static::class等也受其影响。
命名空间不匹配时 new 会报 Class not found
PHP 不会自动把当前命名空间“补全”到类名上，哪怕类文件就在同一目录、命名也一致。比如你在 App\Controllers 下写了 UserController 类，但没加 namespace App\Controllers;，那它实际属于全局命名空间；此时用 new UserController() 能成功，但用 new App\Controllers\UserController() 就会报错——因为 PHP 找不到那个完整路径下的类。
常见错误现象：Fatal error: Uncaught Error: Class "App\Controllers\UserController" not found，其实不是文件没加载，是命名空间声明漏了或写错了。
- 每个 PHP 类文件开头必须有且仅有一个
namespace声明（除非明确要放全局空间） -
use语句只影响当前文件的类引用写法，不改变类本身的归属空间 - 自动加载器（如 Composer 的
autoload.php）靠的是namespace+class名拼出文件路径，写错一个字母就加载失败
use 和 new 中的命名空间写法差异
use 是“起别名”，new 是“调用入口”。这两处对命名空间的处理逻辑完全不同：前者决定你代码里怎么写类名，后者决定 PHP 实际去哪个空间里找类。
比如：
立即学习“PHP免费学习笔记（深入）”；
use App\Services\Logger; new Logger(); // ✅ 等价于 new App\Services\Logger()
但如果你写：
use App\Services; new Services\Logger(); // ❌ 错！Services 不是类，不能当命名空间片段直接拼
-
use后只能跟完整命名空间路径，不能截断中间段（如不能use App\Services;然后写new Services\Logger()） - 想省略前缀，得用
use App\Services\Logger as Log;，再写new Log() - 全局空间的类（如
Exception）必须加反斜杠\Exception，否则 PHP 会去当前命名空间下找
子命名空间继承父级作用域？不，PHP 没有“作用域继承”这回事
很多人以为 namespace App; 后面的 namespace Models; 会自动变成 App\Models，其实不会。PHP 的 namespace 声明是绝对路径，不是相对路径。
错误写法：
namespace App; namespace Models; // ❌ 这定义的是全局 Models，不是 App\Models
正确写法只有两种：
-
namespace App\Models;（完整声明） - 或者在文件开头就写
namespace App\Models;，别拆开
混淆点在于：目录结构常模仿命名空间，但 PHP 不读目录，只认 namespace 声明。Composer 自动加载也是按声明来的，不是按文件位置猜的。
trait 和 interface 的命名空间规则和类完全一致
别以为 trait 或 interface 可以“松一点”。它们和 class 一样，必须严格匹配 namespace 声明 + use 引用 + 自动加载路径。
典型踩坑场景：
- 写了
trait FormatHelper在App\Traits下，但忘了加namespace App\Traits;→ 加载失败 - 在类中
use FormatHelper;，却没use App\Traits\FormatHelper;或对应use别名 → 找不到 trait - trait 中用了同命名空间下的其他类，但没加反斜杠或
use，导致解析到当前类所在空间 → 运行时报Class not found
最易被忽略的一点：命名空间影响的不只是“能不能 new 出来”，它还决定 static::class、get_class()、类型提示（type hint）校验、反射（ReflectionClass）拿到的完整类名——这些地方一旦出错，调试时看到的类名可能和你预期的完全对不上。
