自定义 Facade 类必须置于 app\Facade 目录且命名空间匹配，getFacadeClass() 必须返回带反斜杠的完整目标类命名空间，绑定需在首次调用前通过 Facade::bind() 完成，别名需用 Loader::addClassAlias() 显式注册。
自定义 Facade 类必须放在 app\Facade 目录下
ThinkPHP 框架在加载 Facade 时，会严格按命名空间查找，think\Facade 基类的自动解析逻辑默认只认 app\Facade（或你显式配置的别名命名空间）下的子类。如果你把自定义 Facade 放在 app\common\Facade 或 app\facade（小写）等路径，框架启动时不会自动注册，调用时直接报 Class not found。
常见错误现象：Test::hello() 报错 “Undefined class constant 'hello'” 或 “Call to undefined method”，其实不是方法问题，而是 PHP 根本没加载到这个 Facade 类——因为自动加载器找不到它。
-
app\Facade\Test.php✅ 正确路径，命名空间为app\Facade -
app\facade\Test.php❌ 小写目录名，PSR-4 自动加载失败 -
app\common\Facade\Test.php❌ 命名空间不匹配，除非手动修改Loader::addClassAlias() -
extend\mylib\Facade\Test.php❌ 未注册命名空间，需额外配置 autoload
getFacadeClass() 返回的路径必须是完整命名空间
Facade 类本身只是代理，真正干活的是它指向的目标类。所以 getFacadeClass() 的返回值不是文件路径，而是目标类的全限定命名空间（含 \ 开头）。
比如你要代理 app\common\Test 类，getFacadeClass() 必须写成：
立即学习“PHP免费学习笔记（深入）”；
protected static function getFacadeClass()
{
return 'app\common\Test';
}
容易踩的坑：
- 漏掉引号，写成
return app\common\Test;→ PHP 解析为常量，报Use of undefined constant - 写成相对路径如
'common\Test'→ 找不到类，报Class 'common\Test' not found - 目标类没加命名空间，或命名空间与文件物理路径不一致 → 即使 Facade 加载成功，也会在运行时抛出实例化失败
不写 getFacadeClass() 也能用，但得靠 Facade::bind()
如果你不想每个 Facade 都写 getFacadeClass()，可以在应用初始化阶段统一绑定。推荐位置是 app/common.php 或 app/bootstrap.php 开头。
示例（绑定单个）：
use think\Facade;
Facade::bind('app\Facade\Test', 'app\common\Test');
示例（批量绑定）：
Facade::bind([
'app\Facade\Test' => 'app\common\Test',
'app\Facade\Payment' => 'app\service\PaymentService',
]);
注意点：
- 第一个参数是 Facade 类的完整类名（即你写的
app\Facade\Test），不是别名 - 第二个参数是目标类的完整类名，和
getFacadeClass()返回值格式一致 - 绑定代码必须在任何 Facade 被调用之前执行，否则首次调用会触发默认（失败）解析逻辑，后续再 bind 也无效
别名不是必须的，但用了要配 Loader::addClassAlias()
像 Config、Route 这些能直接 use Config 调用，是因为框架在 base.php 里通过 Loader::addClassAlias() 注册了类名别名。你自己写的 Facade 默认没有这个待遇。
如果希望用户能写 use Test; 而不是 use app\Facade\Test;，就得手动加别名：
Loader::addClassAlias([
'Test' => 'app\Facade\Test',
]);
这个调用一般也放在 app/common.php 或 app/bootstrap.php，且必须在 Facade::bind() 之后、任何 use Test 之前执行。否则 use Test 会找不到类，报 Class 'Test' not found。
复杂点在于：别名、绑定、目录结构、命名空间这四者必须全部对齐，缺一不可；任一环节错位，都会表现为“静态方法调用失败”，但真实原因可能藏在任意一层。
