namespace必须位于文件最顶部（仅可紧随declare后），因其是编译指令而非运行时语句，决定后续类函数的默认作用域；前置BOM、空格、注释或代码均导致Fatal error。
namespace 声明必须是文件最顶部的第一个有效语句，否则直接报 Fatal error: Namespace declaration statement has to be the very first statement in the script。这不是警告，是编译期硬错误，连后续代码都不会解析。
为什么 namespace 必须在文件最开头？
因为 namespace 是 PHP 的编译指令，不是运行时语句。它决定了整个文件中未加反斜杠的类名、函数名的默认归属作用域。
常见破坏“最开头”位置的情况：
- 文件开头有 UTF-8 BOM 字节（尤其 Windows 编辑器保存时默认带）
- 首行有空格、制表符或空行
-
echo、print、注释（哪怕//或/* */）写在namespace之前 - 除了
declare(strict_types=1)，其他任何declare都不被允许前置
实操建议：用 VS Code 打开文件 → 设置里开启 “Render Whitespace” → 检查第 1 行第 1 列是否为 <?php 紧跟 namespace；或者用 hexdump -C yourfile.php | head -n2 查看是否有 ef bb bf（BOM）。
立即学习“PHP免费学习笔记（深入）”；
use 和 new 的关系经常被误解
use 只是给类名起别名，**不触发自动加载**；真正触发加载的是你第一次「使用」该类——比如 new User()、User::find() 或 function_exists('some_func')（对函数而言）。
所以你写了 use AppModelsUser; 却报 Class 'User' not found，问题一定出在自动加载器没配好，而不是 use 写错了。
关键点：
- CLI 下能跑通，Web 下报错？大概率是 Web 环境没执行
composer dump-autoload或没引入vendor/autoload.php - 动态实例化必须传全限定名字符串：
$class = 'AppModelsUser'; new $class();——use别名在这里完全无效 -
use不支持通配符，也不能用变量拼接：use AppModels{$name};是语法错误
PSR-4 路径映射失败的三个高频原因
Composer 的 PSR-4 自动加载要求命名空间前缀、目录路径、类名三者严格对应。错一个就 Class not found，但错误信息不会告诉你哪一环断了。
检查顺序建议：
- 确认
composer.json中"autoload": {"psr-4": {"App\": "src/"}}的末尾反斜杠存在且是双反斜杠（\），单反斜杠会被 JSON 解析吞掉 - 确认类文件实际路径是
src/Models/User.php，不是src/models/User.php（Linux 区分大小写） - 确认该文件第一行是
namespace AppModels;，注意中间是反斜杠，不是斜杠或下划线
小技巧：运行 composer show -p 查看当前已注册的 PSR-4 映射；用 composer dump-autoload -o 强制重生成优化后的自动加载文件，有时能暴露路径拼接问题。
在命名空间内调用全局函数要加反斜杠
如果你在 AppControllers 命名空间里写了 date('Y-m-d');，PHP 会先去 AppControllersdate 找函数，找不到才回落到全局 date。一旦你或某个依赖不小心定义了同名函数，就会静默调错。
安全写法始终是显式加反斜杠：
date('Y-m-d')strlen($str)-
Exception（而不是裸写Exception，否则可能误用当前命名空间下的同名类）
这个习惯看起来啰嗦，但能避免大量隐性兼容问题，尤其是当你开始用静态分析工具（如 PHPStan）时，它会明确提醒你哪些全局函数调用缺少反斜杠。
真正的坑不在语法多难，而在于「你以为它自动做了什么，其实它根本没做」——比如 use 不加载、namespace 不绑定路径、全局函数不自动回退。盯住这些边界，比背熟所有规则更管用。
