Intelephense无法识别Facade方法，因其静态分析不执行PHP运行时逻辑，无法解析__callStatic和getFacadeClass()动态代理；需添加@mixin注释指向真实实现类以恢复补全与跳转。
VSCode + Intelephense 无法识别 Facade 方法
不是代码写错了，是 Intelephense 静态分析根本“看不到” Facade 的真实方法。它只解析类定义和 use 语句，而 Db::table() 这类调用背后靠的是 __callStatic + 容器动态代理，运行时才决定调用哪个实例的哪个方法 —— Intelephense 不执行 PHP，自然不理解这层跳转。
典型表现：cache::get('key') 报红、Ctrl+Click 跳不到 think\cache、链式方法（如 where()、select()）无补全，但运行完全正常。
- Intelephense 默认不会读取
bootstrap/app.php中的Facade::bind()调用，所以你手动绑定的'my_service' => 'app\common\MyService'对它无效 - 即使 Facade 类里写了
getFacadeClass()，Intelephense 也不会去解析这个返回值并索引目标类的方法 - TP6+ 的
config/app.php中'aliases'数组里的映射，Intelephense 也基本忽略
ThinkPHP 6+ 中 Facade 提示的临时补救方案
想让 VSCode 补全 Db、Cache 等系统 Facade，最直接有效的方式是加 PHPDoc 注释，告诉编辑器“这个静态类实际代理的是哪个类”：
/** @mixin \think\db\Connection */
class Db extends \think\Facade
{
protected static function getFacadeClass()
{
return 'db';
}
}对自定义 Facade 同理：
立即学习“PHP免费学习笔记（深入）”；
/** @mixin \app\common\Test */
class Test extends \think\Facade
{
protected static function getFacadeClass()
{
return 'app\common\Test';
}
}- 必须把
@mixin注释写在 Facade 类声明的正上方，不能漏掉 -
\think\db\Connection是真实提供table()、where()等方法的类，不是容器标识符'db' - 如果目标类本身也有 Facade（比如
think\cache\Cache），要指向它的最终实现类（如\think\cache\driver\File），否则仍无方法提示
为什么 getFacadeClass() 返回字符串而不是类名会失效
常见错误是把 getFacadeClass() 写成：
protected static function getFacadeClass()
{
return \app\common\Test::class; // ❌ 错误：返回完整类名字符串，但没注册进容器
// 或
return 'app\common\Test'; // ✅ 正确：前提是该类已通过 bind() 或容器自动解析支持
}问题不在 Facade 本身，而在容器能否 resolve 出实例。Intelephense 不关心这个，但运行时报错会是：
InvalidArgumentException: Identifier "app\common\Test" is not registered.
- 返回值是容器中的服务标识（service identifier），不是命名空间路径；它可能对应一个闭包、一个已绑定的类、甚至一个配置键
- 例如
return 'cache'，真正干活的是think\cache\Cache实例，但容器里绑定的是cache→think\cache\Cache这一映射 - 如果你没在
bootstrap/app.php或服务提供者中显式bind()，又没在容器里bind('app\common\Test', ...)，那就算字符串写对了，运行时也挂
CLI 环境下 Facade 报错但 IDE 没提示
tinker 或 Artisan 命令里 Db::table() 报 Class 'think\facade\Db' not found，往往和 IDE 提示无关，而是环境加载缺失：
- 确认
think\facade\Db类文件存在且命名空间正确；TP6 默认启用，但某些精简版或迁移项目可能漏掉composer autoload规则 - 命令行未加载
bootstrap/app.php（尤其自定义入口或测试脚本），导致Facade::bind()没执行 - 缓存未清：改过
config/app.php的aliases后，必须运行php artisan config:clear，否则旧缓存还在 - 别在命令类的属性初始化阶段调用 Facade，比如
protected $db = Db::table('user');—— 此时容器还没 ready，应移到handle()方法内
IDE 提示和 CLI 运行是两套逻辑：前者卡在符号索引，后者卡在容器生命周期。一个报红一个报错，原因完全不同，不能互相推断。
