Laravel 6 的 Facade 和依赖注入补全失效，根本原因是其动态调用（如 __callStatic）和容器解析无法被 VSCode 静态分析；必须通过 barryvdh/laravel-ide-helper ^2.8/2.9 生成 _ide_helper.php 和 _ide_helper_models.php 等静态元数据文件，并配合 Intelephense 正确配置 includePaths 与手动索引，才能恢复完整提示。
VSCode 里 Laravel 6 的依赖注入和 Facade 补全失效，不是容器坏了，而是 IDE 没“看懂”运行时行为——必须靠 barryvdh/laravel-ide-helper 生成静态元数据才能恢复。
为什么 Laravel 6 的 app() 和门面不提示？
Laravel 6 大量使用 __callStatic（如 Auth::user()）和服务容器动态解析（如 app(CacheService::class)），这些在 PHP 运行时才确定，VSCode 的 intelephense 默认无法推断。它只读源码，不跑代码，所以看到 Auth 就认为是个空类，补全自然为空。
- 现象：输入
DB::后无方法提示；app('cache')返回类型标为mixed；模型字段$user->email不提示 - 关键区别：Laravel 6 的
ide-helper2.x 版本才兼容，装错版本（比如直接composer require --dev barryvdh/laravel-ide-helper装了 3.x）会导致命令报错或生成文件缺失 - 必须确认：
composer show barryvdh/laravel-ide-helper输出的版本号是否为^2.8或^2.9（对应 Laravel 5.5–6.x）
php artisan ide-helper:generate 报错或没生成 _ide_helper.php
这个命令失败，90% 是因为容器尚未完全加载、门面未注册，或缺少数据库连接（某些门面如 Schema 需要 DB 驱动支持）。Laravel 6 的 ide-helper 在生成时会尝试实例化所有门面，失败即中断。
- 先确保
config/database.php中的'default'配置有效，且 CLI 环境能连上数据库（哪怕只是 SQLite 内存驱动） - 临时注释掉
config/app.php中'providers'数组里非核心的第三方服务提供者（尤其是那些依赖外部 API 或配置未就绪的） - 运行前删掉
bootstrap/cache/config.php和bootstrap/cache/services.php，避免缓存干扰 - 如果仍报
Target class [xxx] does not exist，在config/ide-helper.php的'exclude'项中加入该类名字符串（如'App\Providers\CustomServiceProvider'）
模型字段补全还是不工作？检查 ide-helper:models 执行细节
php artisan ide-helper:models 生成的 _ide_helper_models.php 是模型属性补全的唯一来源，但它默认只处理 app/Models 下的类，且要求每个模型都继承 IlluminateDatabaseEloquentModel 并能被正确反射。
- 必须安装
doctrine/dbal：否则ide-helper:models无法读取数据库 schema，字段将全部丢失 - 执行命令时加
-W（大写 W）参数：即php artisan ide-helper:models -W，否则不会覆盖已有文件，旧字段残留导致误判 - 如果模型用了
$casts或$appends，需在模型类顶部手动加 PHPDoc，例如：/** @property string $full_name */，ide-helper不自动识别运行时附加属性 - 注意命名空间：若模型不在
AppModels下（比如放在AppEntities），需在命令后显式列出全类名：php artisan ide-helper:models AppEntitiesUser
重启 VSCode 后补全仍延迟或不更新
Intelephense 缓存的是整个项目符号表，不是实时监听文件变化。即使你刚生成了新 _ide_helper.php，它也可能还在用旧索引。
- 强制重载：按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Intelephense: Index workspace并执行 - 检查
intelephense.environment.includePaths设置，确保包含项目根目录（而非只含app或vendor） - 不要忽略
.gitignore里对_ide_helper*.php的排除——虽然它们是生成文件，但 Intelephense 必须能读到它们，否则补全直接失效 - 最隐蔽的坑：Laravel 6 默认启用
opcache.enable_cli=1，可能导致intelephense加载了过期的 OPcache 字节码，临时关闭 CLI 的 OPcache 更可靠
补全不是“装完插件就自动好”，而是每次模型改字段、新增门面、升级 Laravel 小版本，都得重新跑一遍 ide-helper:generate 和 ide-helper:models。漏掉一次，后续开发就会陷入“写一半发现没提示，回头查文档”的循环。
