命名空间是PHP中解决同名冲突的逻辑前缀，必须紧接在<?php后声明；自动加载通过spl_autoload_register()实现，PSR-4要求命名空间与目录严格映射，配置后需执行composer dump-autoload并引入vendor/autoload.php。
命名空间是代码的“姓氏”，不是可选项
PHP 命名空间本质是给类、函数、接口、常量加一个逻辑前缀，解决同名冲突问题。比如两个 User 类，一个来自项目业务层（AppModelsUser），一个来自第三方 SDK（VendorAuthUser），没有命名空间就无法共存。
关键硬性规则：
- namespace 必须紧接在 <?php 后面，前面不能有任何内容（包括空行、注释、declare）
- 一个文件只应定义一个命名空间，多命名空间虽语法允许，但会破坏 PSR-4 映射，Composer 不识别
- 全局命名空间（无 namespace 声明）的类，引用时必须写成 DateTime 这样的完全限定名，否则会被当作当前命名空间下的子类
- use 只影响静态写法，比如 use AppModelsUser; 后可用 new User()；但它对 new $className 这类动态类名无效
自动加载不是“锦上添花”，而是运行前提
PHP 本身不自动找类文件。当你写 new AppModelsUser() 而类尚未加载，PHP 就报 Class 'AppModelsUser' not found——哪怕文件真实存在且路径正确。自动加载就是补上这个缺口的机制。
核心原理是：通过 spl_autoload_register() 注册回调函数，在实例化未定义类时触发，按规则拼出文件路径并 include 或 require。
立即学习“PHP免费学习笔记（深入）”；
注意：__autoload() 已废弃，不可用；必须用 spl_autoload_register()，且推荐交由 Composer 管理。
PSR-4 是事实标准，映射规则必须严格对齐
Composer 默认遵循 PSR-4 规范，它把命名空间前缀和物理目录绑定起来。例如配置：
"autoload": { "psr-4": { "App\": "src/" } }
意味着：
- AppControllersHomeController → 对应文件 src/Controllers/HomeController.php
- AppModelsUser → 对应文件 src/Models/User.php
- AppUtilsHelper → 对应文件 src/Utils/Helper.php
要点：
- 命名空间中的 被替换成系统目录分隔符（/ 或 ）
- 前缀（如 App）被截掉，剩余部分直接映射为子路径
- 大小写必须完全一致（Linux 下敏感，Windows 下易掩盖问题）
- 配置后需执行 composer dump-autoload 生效，入口文件引入 vendor/autoload.php
常见错误与排查思路
类找不到？别急着改 require，先检查这几点：
- 文件顶部是否有非法前置内容（空格、BOM、注释）导致 namespace 报错
- 类文件是否放在了正确的路径下，命名是否与类名严格一致（User.php 里必须是 class User）
- composer.json 中的 PSR-4 前缀是否以反斜杠结尾（"App\"，不是 "App" 或 "App"）
- 是否漏掉 vendor/autoload.php 的引入，或引入位置不在其他类使用之前
- 动态类名（如 new $class）不走 use，必须传入完全限定名（"AppModelsUser"）
