PhpStorm 识别 Laravel 需三步：生成 _ide_helper.php 提供类型定义、启用 Laravel 插件开启语义支持、配置 Blade/Artisan/asset 路径对齐运行时；缺一不可，首步未完成则 User::find() 标红、Auth 无法跳转。
PhpStorm 本身不“配置 Laravel”，而是通过三类动作让 Laravel 代码可识别、可跳转、可调试：加载类型存根（_ide_helper.php）、启用框架语义支持（Laravel 插件）、对齐运行时上下文（Artisan / Blade / asset 路径）。缺一不可，但最容易卡在第一步。
为什么 User::find() 标红、Auth 无法 Ctrl+Click 跳转
根本原因不是插件没装，而是 PhpStorm 没看到 Laravel 的类型定义。它不知道 Auth 是 facade、User 是 Eloquent 模型、DB 来自哪个命名空间。
- 必须用
composer require --dev barryvdh/laravel-ide-helper安装包（Laravel 10+ 推荐 v2.12+） - 执行
php artisan ide-helper:generate，生成_ide_helper.php到项目根目录（不是vendor/） - 确认该文件未被
.gitignore屏蔽（否则 PhpStorm 扫不到） - 右键项目 → Reload project from Disk，强制刷新索引（不是重启 IDE）
- 检查
Settings → PHP → Include Path是否包含vendor/barryvdh/laravel-ide-helper/src（新版通常自动添加）
Laravel Plugin 启用后仍不识别 @extends 或 route()
插件只是“开关”，不自动解决路径解析。Blade 指令和辅助函数（如 asset()、url()）需要明确告诉 PhpStorm 哪些是模板、哪些是资源入口。
- 进入
Settings → Languages & Frameworks → PHP → Laravel，勾选 Enable Laravel support - 在同页设置 Blade directories：添加
resources/views（必须是相对路径，不能写绝对路径） - 设置 Public directory 为
public（否则asset('css/app.css')会标红） - 若使用 Laravel Vite，还需在
Settings → Languages & Frameworks → JavaScript → Libraries中添加resources/js和node_modules到库路径
Artisan Console 报 Class 'App\Console\Kernel' not found
这不是代码错，是 PhpStorm 的内置终端没加载 Laravel 的 autoloader。它启动的是一个干净的 PHP 进程，不认识你的 app/ 目录结构。
立即学习“PHP免费学习笔记（深入）”；
- 进
Settings → Tools → Laravel → Laravel Artisan Console - 勾选 Enable Laravel Artisan console
-
Artisan path必须指向项目根目录下的artisan文件（不是全局php artisan） - 检查
PHP interpreter是否为项目本地 PHP（如./vendor/bin/php或 Valet/Docker 环境），而非系统/usr/bin/php - 如果用 Docker，需在
PHP interpreter → Docker Compose中指定正确的service和volume挂载（否则app/Console/Kernel.php不可见）
哪些插件真有用，哪些可以删
JetBrains 官方数据表明：每多一个活跃插件，内存占用平均增 120MB，启动慢 0.8 秒。Laravel 开发真正绕不开的只有两个：
-
Laravel Plugin（JetBrains 官方维护）：提供路由跳转、Blade 指令补全、
config/*键名提示——禁用后Route::get('api/users', [UserApiController::class, 'index'])就没法 Ctrl+Click 进控制器 -
Laravel Idea（非免费，但功能远超免费插件）：支持模型字段补全、作用域自动提示、请求类规则生成、Livewire 组件双向跳转——
User::whereActive()->with('posts')->get()中的whereActive会实时提示是否为 scope 方法 - 其他如 “PHP Toolbox”、“String Manipulation” 等，原生 PHPStorm 已覆盖大部分功能，装了反而容易冲突
最常被忽略的一点：Laravel Idea 的模型字段补全依赖 php artisan ide-helper:models 生成的注释，且必须在 Settings → Languages & Frameworks → PHP → Laravel 中开启 Model annotations，否则字段名不会出现在补全列表里。
