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