命名空间声明必须位于PHP文件最顶部，前面不能有任何输出（包括空白、BOM、echo等），否则报Fatal error；常见原因是编辑器添加了UTF-8 BOM，应改为“UTF-8 without BOM”。
命名空间声明必须在文件最顶部，且前面不能有任何输出
PHP 的
声明不是普通语句，它属于“编译指令”，一旦文件开头有空白、BOM 字符、
、甚至 UTF-8 的 BOM（隐藏字节），就会直接报错：
。
常见踩坑点：
编辑器自动加了 UTF-8 BOM（尤其 Windows 下的记事本或老版 Notepad++）——用 VS Code 或 Sublime 打开，转成 “UTF-8 without BOM”
前有空格或换行
写了
却放在
前面（这是非法的，必须后置）
正确写法只有这一种顺序：
use 关键字不是导入，而是创建当前作用域下的别名
不会把类“复制”进当前文件，它只是告诉 PHP：“以后我写
，其实指的是
”。所以它不解决自动加载问题，也不影响性能——只是语法糖。
立即学习
“
PHP免费学习笔记（深入）
”；
典型误用场景：
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
以为
后就能直接 new User() —— 实际上还要确保
类真实存在且能被自动加载（比如 Composer 的 autoload 配置正确）
在同一个文件里对同一个类用了多个
别名，比如
和
并存 —— 会报
想用
导入函数或常量？PHP 5.6+ 才支持
和
，且必须显式写出，例如：
全局类和命名空间类混用时，记得加反斜杠
当你在命名空间内想调用 PHP 内置类（如
、
）或根命名空间下的类，必须写成
，否则 PHP 会尝试在当前命名空间下找
，然后报
。
常见错误写法：
→ 应为
→ 应为
连
这种函数都可能出问题（如果当前命名空间下恰好定义了同名函数），稳妥起见可写
，但通常不用
Composer 自动加载与命名空间路径必须严格匹配
你写了
，那这个类文件就必须放在
（或你配置的对应路径下），否则 Composer 的 PSR-4 自动加载找不到它，报
。
检查要点：
composer.json 中
的映射是否正确（注意双反斜杠是 JSON 字符串转义）
文件路径里的目录分隔符是
，不是
（即使在 Windows 上也要用正斜杠）
类名大小写必须和文件名完全一致（Linux 下敏感，开发时就该按 Linux 规范写）
改完命名空间或移动文件后，必须运行
，否则缓存没更新
一个典型失败例子：
命名空间本身不难，难的是所有环节都要对齐：文件位置、声明顺序、
写法、自动加载配置、错误时的反斜杠补全——漏掉任意一环，报错信息都可能指向错误的方向。
namespaceechoFatal error: Namespace declaration statement has to be the very first statement in the scriptdeclare(strict_types=1);namespaceuseUserAppModelsUseruse AppModelsUser;AppModelsUseruseuse AppModelsUser as AdminUser;use AppModelsUser;Fatal error: Cannot use AppModelsUser as User because the name is already in useuseuse functionuse constuse function array_filter;ExceptionDateTimeExceptionAppHttpControllersExceptionClass 'AppHttpControllersException' not foundthrow new Exception('msg');throw new Exception('msg');$date = new DateTime();$date = new DateTime();strlen()strlen($str)namespace AppServices;app/Services/SomeService.phpClass AppServicesSomeService not found"psr-4": { "App\": "app/" }/composer dump-autoloadnamespace AppServices;
// 文件却放在 app/Helpers/EmailService.php → 自动加载永远失败
use