必须安装PHP Intelephense扩展，它基于符号索引实现静态分析，支持Laravel类、路由、Facade别名识别；需启用工作区、确保composer install完成、配置includePaths并保留phpdoc注释。
PHP Intelephense 扩展必须装，别信 PHP Server
VSCode 默认不带 PHP 语言智能提示，PHP Server 这类扩展只起本地服务，对跳转、补全毫无帮助。真正起作用的是 Intelephense —— 它基于符号索引做静态分析，能识别 app/ 下的类、routes/web.php 里的闭包路由、甚至 Facade 别名（比如 Auth → Illuminate\Support\Facades\Auth）。
常见错误现象：Ctrl+Click 点不进 Route::get() 的回调函数，或者 $request->validate() 没参数提示。大概率是没启用 Intelephense，或它没扫描到 vendor 目录。
- 装完插件后，右下角点灯泡图标 → “Enable for Workspace”，别只点“Enable”
- 确保项目根目录有
composer.json，且已运行过composer install（否则vendor/autoload.php缺失，Intelephense 索引不到 Laravel 核心类） - 如果路由跳转仍失效，检查
intelephense.environment.includePaths设置里是否包含vendor/laravel/framework/src/Illuminate
Laravel Artisan 命令生成的代码才被正确识别
Intelephense 对手写代码的推断能力有限，尤其涉及动态绑定的路由和控制器方法。比如你手动在 routes/web.php 写 Route::get('/user', 'UserController@show');，它能跳转；但写成 Route::get('/user', [\App\Http\Controllers\UserController::class, 'show']); 就可能失败——因为字符串路径没被解析为真实类引用。
使用场景：写新路由时，优先用 php artisan make:controller UserController --resource 生成标准结构。这样 Intelephense 能通过命名约定（App\Http\Controllers\UserController）和 use 语句准确定位。
立即学习“PHP免费学习笔记（深入）”；
- 避免在路由文件里用字符串控制器名，改用数组语法 +
::class常量（Laravel 8+ 推荐写法） - 自定义命令行生成的类（如
php artisan make:request StoreUserRequest）会被自动识别，字段验证规则也能提示 - 如果你用了
Route::middleware('auth')->group(...)包裹，Intelephense 不会因此丢失内部路由的跳转能力
blade.php 文件里写 @auth 或 {{ $user->name }} 没提示？检查 Blade 插件和视图路径
Blade 模板的变量提示依赖两个条件：一是 Blade Snippets 或 Blade Spacer 这类插件提供基础语法高亮和片段，二是 Intelephense 必须知道当前 Blade 文件里 $user 是从哪来的。它不会主动读 with() 或 compact()，但能识别 view('user.index', ['user' => $user]) 中的键名。
容易踩的坑：return view('user.index')->with('user', $user); 这种链式调用，Intelephense 很难推断出 $user 类型；而 view('user.index', compact('user')) 也不行，因为 compact() 返回数组，类型信息丢失。
- 用
view('user.index', ['user' => $user])显式传参，Intelephense 才能将$user和控制器里变量类型对齐 - 安装
Blade Formatter（非必需但推荐），避免格式混乱导致语法解析失败 - 如果
@foreach($users as $user)里$user没提示，说明$users类型未被识别，回溯检查控制器中$users = User::all();是否用了 Eloquent 模型（而非原生查询）
vendor 目录太大导致索引慢或卡顿？关掉不必要的扫描
Intelephense 默认会递归扫描整个 vendor，但 Laravel 项目里真正需要的是 laravel/framework 和你的 app/ 目录。扫描 node_modules 或 vendor/bin 属于纯浪费资源，还可能触发内存溢出警告。
性能影响：首次索引可能耗时 1–3 分钟，后续编辑基本无感；但如果 VSCode 右下角一直显示 “Indexing…” 或 CPU 占用持续高于 70%，大概率是路径配置太宽。
- 在工作区设置里加这一段：
"intelephense.environment.includePaths": [ "./vendor/laravel/framework/src/Illuminate", "./app" ]
- 删掉
"intelephense.files.maxSize"默认值（5MB），Laravel 的vendor/laravel/framework/src/Illuminate/Foundation/Testing/TestCase.php超过这个大小，会导致部分测试类不被索引 - 不要在
.vscode/settings.json里写"intelephense.stubs"手动加一堆 .php 文件，新版 Intelephense 已内置 Laravel stubs
复杂点在于：路由跳转和模型关联提示（比如 $user->posts）高度依赖 phpdoc 注释和 Eloquent 方法签名。如果你删了模型里的 @property-read \Illuminate\Database\Eloquent\Collection<int post> $posts</int>，哪怕代码逻辑完全正确，Intelephense 也大概率提示不出 $post->title。这点很容易被忽略，但改起来就一行注释的事。
