Namespace必须位于php文件最顶部且前面不能有任何输出，包括空格、bom、echo或不可见字符；declare(strict_types=1)是唯一允许在namespace前的语句。
namespace 必须写在文件最顶部，且前面不能有任何输出
PHP 的 namespace 声明不是普通语句，它属于编译指令。一旦文件开头有空格、BOM 字符、echo、甚至 UTF-8 的不可见字节，就会报错：Fatal Error: Namespace declaration statement has to be the very first statement in the script。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用编辑器显示空白字符（如 VS Code 开启 “Render Whitespace”），确认文件首行绝对干净
- 所有
namespace声明前禁止declare()（除非是declare(strict_types=1)，它被允许在 namespace 之前） - 如果用了
require或include引入其他文件，确保被引入的文件也遵守该规则——否则错误会出现在引入处，但根因在被引入文件
use 和 fully qualified name 的区别和选法
use 是别名机制，不加载类；真正触发自动加载的是你第一次「使用」那个类（比如 new Someclass()）。很多人以为写了 use 就等于导入，结果在 CLI 下跑正常，Web 环境却报 Class not found，其实是自动加载器没配好，use 背锅了。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 短名优先：用
use AppModelsUser;后，直接写new User()，比写new AppModelsUser()清爽且可读 - 冲突时必须用全限定名：比如同时
use DateTime;和use carbonCarbon;，而你要用 PHP 原生DateTime，就得显式写new DateTime() -
use不支持动态类名：像$class = 'AppServicesLogger'; new $class();这种写法，必须传全限定名字符串（含反斜杠），不能依赖use别名
子命名空间和文件路径不是强绑定，但 PSR-4 要求它们一致
PHP 本身不关心 namespace AppControllers; 对应哪个目录。但 composer 的 PSR-4 自动加载规则强制要求：命名空间前缀（如 App）映射到某个物理路径（如 src/），且子命名空间名必须逐级对应子目录。否则 new AppControllersHomeController() 会找不到文件。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 检查
composer.json中"autoload": {"psr-4": {"App": "src/"}}配置，注意末尾反斜杠和路径斜杠方向 - 文件路径里不能有大写错位：比如
namespace AppModels;对应src/Models/User.php是对的，但写成src/models/User.php在 linux 下就加载失败 - 别手动 include 文件来“绕过”自动加载——这会让依赖关系隐晦，测试和维护都变困难
全局作用域类和命名空间内同名类的调用陷阱
在命名空间内，不带反斜杠的类名（如 Exception）会被解释为当前命名空间下的类，而不是 PHP 内建的 Exception。所以 throw new Exception() 在 AppServices 下实际找的是 AppServicesException，大概率不存在，直接报错。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 所有 PHP 内建类、函数、常量，在命名空间内调用时，要么加反斜杠前缀（
Exception、strlen()、JSON_THROW_ON_ERROR），要么用use显式引入（use Exception;） - 函数调用特别容易漏：写
array_merge()没问题，但json_encode()如果当前命名空间下恰好有同名函数，就会覆盖——加最保险 - 第三方包若未声明
namespace，它里面的类默认在全局空间，引用时必须用VendorClass
命名空间真正的复杂点不在语法，而在它和自动加载、类发现、ide 补全、以及测试环境之间的耦合。一个 use 写错或路径映射少了个斜杠，可能让错误出现在完全无关的代码行里。