PHP命名空间必须与文件路径、自动加载规则、调用上下文严格对齐：namespace须位于文件首行（前仅允许declare语句），文件须为无BOM UTF-8；use导入类而非路径，同名类需as别名；调用时非限定名会按当前命名空间解析，全局函数/常量建议加反斜杠前缀；PSR-4要求类名、命名空间、文件路径三者完全匹配。
PHP命名空间不是“加了就完事”的装饰，用错位置、导错路径、混用全局函数，三秒内就能触发 Fatal error: Class 'X' not found 或 Call to undefined function。核心原则只有一条：**命名空间必须与文件系统路径、自动加载规则、调用上下文三者严格对齐**。
namespace 必须写在文件最顶上，且前面不能有空行或输出
这是最常踩的硬性错误。哪怕顶部多一个空格、一个 UTF-8 BOM、或一句 echo '';，PHP 都会直接报 Parse error: syntax error 或静默失效——后面所有 use 和类定义都算白写。
-
namespace前唯一允许的 PHP 语句是declare(encoding='UTF-8')或declare(strict_types=1) - 文件必须保存为「无 BOM 的 UTF-8」，编辑器里要手动关掉 BOM 选项（VS Code / PHPStorm 默认可能开启）
- 如果需要同时写全局代码和命名空间代码，只能用大括号语法：
namespace App { ... }+namespace { ... }
use 导入的是“类名”，不是“路径”；别名必须显式声明
use 不是 require，它不加载文件，只是给完全限定名起个本地简称。很多人误以为 use AppServices 就能访问 AppServicesPayment，其实不行——它什么都没导入，只是声明了一个命名空间别名，但 PHP 不支持命名空间别名用于后续拼接。
- 正确导入类：
use AppServicesPayment;→ 后续可用new Payment() - 导入同名类必须用
as：use AppModelsUser; use AdminModelsUser as AdminUser; - 导入函数或常量需显式声明类型：
use function AppHelpersstr_slug;，use const AppConstantsSTATUS_ACTIVE; -
use AppServices;单独写这行毫无作用，也不会让Payment自动可访问
调用时的名称解析规则决定你到底在找谁
PHP 对类/函数/常量的查找分三级：非限定名（如 new User()）、限定名（如 new ServicesUser()）、完全限定名（如 new AppServicesUser()）。它们的解析逻辑完全不同，尤其容易在函数调用上翻车。
立即学习“PHP免费学习笔记（深入）”；
- 在命名空间
AppControllers中写new User()→ 实际找的是AppControllersUser，不是AppModelsUser - 写
strlen()时，如果当前命名空间下没有strlen函数，PHP 会自动回退到全局函数；但若你定义了function strlen() { ... }，那就真会覆盖，且不会警告 - 调用全局函数保险写法是加反斜杠：
strlen($str)，避免被同名函数劫持 - 常量同理：
PHP_VERSION比PHP_VERSION更可靠，尤其在定义了同名常量的命名空间里
PSR-4 自动加载生效的前提是路径、命名空间、文件名三者咬死
光写 namespace AppModels; 没用，composer dump-autoload 也救不了路径错位的文件。Composer 只按规则“猜”文件在哪，猜错了就加载失败。
- PSR-4 规则：
"App\": "src/"表示AppModelsUser必须位于src/Models/User.php - 类名必须与文件名一致（大小写敏感）：
User.php里必须是class User，不能是class user或class UserModel - 子命名空间层级必须逐级对应目录：
AppServicesPaymentAlipay→src/Services/Payment/Alipay.php - 执行
composer dump-autoload -o（优化模式）后，记得清掉 OPcache，否则改了路径也不生效
真正卡住人的从来不是“怎么写 namespace”，而是“为什么写了却找不到类”。检查顺序应该是：文件编码 → namespace 位置 → PSR-4 路径映射 → use 是否导入正确类 → 调用时是否用了非限定名导致解析错位。每一步断掉，后面全盘无效。
