PHP 8.4命名空间核心仍是namespace声明+use导入+as别名；需严守文件首行规则（无BOM/空行）、同名类必须用as区分、类解析按当前空间→use导入→全局空间优先级进行，且PSR-4要求命名空间与目录结构严格对应。
PHP 8.4 中命名空间的用法和类名冲突解决机制，跟 PHP 7.0+ 一脉相承，没有颠覆性变化——namespace 声明 + use 导入 + as 别名，仍是核心三件套。关键不是“PHP 8.4 新加了什么”，而是你是否踩准了作用域、加载路径和解析顺序这三点。
namespace 必须写在文件最顶部，且前面不能有输出或空白行
这是最容易被忽略却直接导致 Fatal error: Namespace declaration statement has to be the very first statement 的硬规则。哪怕开头多一个空格、BOM 字符、<?php 前的换行，都会报错。
-
namespace必须是 PHP 文件中第一个非declare()的语句 - 文件开头不能有
echo、print、HTML 输出，也不能有 UTF-8 BOM - 如果你用 IDE 生成文件，检查“保存时移除 BOM”选项是否开启
- 常见误操作：在
<?php上方加注释或空行 → 立刻失败
use 导入类时，别名（as）不是可选，而是冲突场景下的必需操作
当两个不同命名空间下存在同名类（比如 App\Models\User 和 Admin\Models\User），不加 as 就直接 use，PHP 会抛出 Fatal error: Cannot use App\Models\User as User because the name is already in use。
- 必须显式用
as区分：use App\Models\User as AppUser;和use Admin\Models\User as AdminUser; - 别名只在当前文件生效，不影响其他文件，也不影响自动加载逻辑
- 别名可以是任意合法标识符，但建议语义清晰，比如
as PaymentGateway比as PG更易维护 - 注意：
use不会触发类加载，只是告诉 PHP “这个短名对应哪个全限定名”
类名解析顺序决定你到底 new 的是谁
PHP 解析类名时，按固定优先级查找：当前命名空间 → 使用 use 导入的别名 → 全局命名空间。很多人以为写了 use App\Services\Logger 就能直接 new Logger()，结果却意外调用了全局的 \Logger（比如 monolog 的 Logger 类），原因就在这里。
立即学习“PHP免费学习笔记（深入）”；
- 如果当前文件在
App\Controllers命名空间下，new Logger()实际尝试实例化的是App\Controllers\Logger - 要明确指向导入的类，必须确保该类已通过
use显式声明，且无同名冲突 - 想强制使用全局类？加反斜杠前缀：
new \DateTime();或new \Exception(); - PSR-4 自动加载器依赖命名空间与目录结构严格对应，比如
App\Models\User必须存在于/src/Models/User.php，否则new User()会报Class 'User' not found
真正容易被绕晕的点，不是语法记不住，而是没意识到：命名空间冲突往往暴露的是自动加载配置错误或文件路径与命名空间不一致。别急着改 use，先确认 composer dump-autoload 是否执行、autoload 配置是否匹配实际目录结构——这才是 PHP 8.4 下类找不到、名冲突反复出现的底层原因。
