命名空间声明必须位于php文件最顶部，前面仅允许空白符和declare语句；use语句仅为创建别名而非加载类；psr-4要求命名空间、目录结构与文件路径严格对应；调用全局类需加反斜杠前缀或use导入。
命名空间声明必须在文件最顶部，且前面不能有任何输出
PHP 解析器要求 namespace 必须是文件中除空白符和 declare 语句外的第一条语句。一旦前面有 echo、print、BOM 字节，甚至空行后的 UTF-8 BOM，都会报错：Fatal error: Namespace declaration statement has to be the very first statement in the script。
实操建议：
- 用编辑器关闭 BOM（尤其 Windows 下的 Notepad++ 或 VS Code 要检查“编码”是否为 UTF-8 无 BOM）
- 避免在
namespace前写注释（PHPDoc 注释除外，它被允许） - 如果用了
declare(strict_types=1);，它必须在namespace之前，且只能有一行 - 单文件多命名空间？不行 —— 一个文件只能有一个
namespace声明（除非用大括号语法，但不推荐）
use 语句不是导入类，而是创建当前作用域下的别名
use 不会把类代码加载进来，也不影响自动加载逻辑，它只是让后续代码能用更短的名字引用某个完全限定名（FQN）。很多人误以为 use 是“引入依赖”，结果在没配好 autoloader 时死活找不到类，其实问题出在 require 或自动加载上，而不是 use 写错了。
常见错误现象：
-
Class 'Helper' not found：写了use AppHelper;，但没 autoload 这个路径，或类文件没按 PSR-4 规则命名/存放 - 同名类冲突时，只
use一个，另一个必须用 FQN（如DateTime）显式调用 -
use不能带变量或动态字符串 —— 它是编译期静态解析的 - 想给类起别名？用
use SomeLongName as Short;，但别名不能和已有类/函数重名
PSR-4 自动加载依赖目录结构与命名空间严格对应
Composer 默认用 PSR-4，它把命名空间前缀（如 App）映射到物理目录（如 src/），然后把剩余命名空间部分转成子目录。比如 AppControllersUserController 必须存在于 src/Controllers/UserController.php 中，且该文件里必须声明 namespace AppControllers;。
容易踩的坑：
- 目录名大小写敏感：Linux 下
controllers/和Controllers/是两个目录，但命名空间Controllers（首字母大写）只会匹配后者 - 文件名必须和类名一致：类
UserController必须在UserController.php，不能叫user_controller.php - composer.json 里配置的映射末尾要不要加反斜杠？要加 ——
"App\": "src/"，少一个反斜杠会导致转义失败 - 改完 composer.json 后忘了运行
composer dump-autoload，导致新规则不生效
全局空间和反斜杠前缀容易被忽略
PHP 中未加反斜杠的类名（如 Exception、DateTime）默认在当前命名空间下查找。如果你在 AppServices 里直接写 new Exception()，PHP 会去找 AppServicesException，而不是内置的 Exception —— 这就是为什么总有人遇到 Class 'AppServicesException' not found。
正确做法：
- 调用内置类或根命名空间类时，统一加前导反斜杠：
new Exception()、json_encode($data) - 或者在文件顶部
use Exception;，这样就不用每次加反斜杠 - 注意：函数没有命名空间隔离，但 PHP 7.4+ 支持
use function，可用来 alias 函数，例如use function mb_strlen as len; - trait 和 interface 同样受命名空间约束，使用方式和 class 一致
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
