必须启用JetBrains官方Laravel插件并重启IDE，再配置Laravel支持、视图路径及应用路径；否则@if无提示、{{ $user->name }}不显示属性、@include无法跳转。
PhpStorm 本身不“支持 Laravel”，而是靠插件和配置告诉它：这是个 Laravel 项目，该用什么规则解析代码。没装对插件、没重启、路径配错，@if 不补全、{{ $user->name }} 不提示、@include('layouts.app') 点不进去，全是必然结果。
必须启用 JetBrains 官方 Laravel 插件（不是第三方）
Blade 指令无高亮、无补全、@endphp 不自动闭合，90% 是因为没开这个插件。它不是可选项，是基础依赖。
- 进
Settings → Plugins，切到Marketplace标签页（别只看 Installed） - 搜
Laravel，认准作者是JetBrains的那个，名称就是Laravel（不是 “Laravel Plugin” 或 “Laravel Idea”） - 勾选启用 → 点
Restart IDE（不是“稍后重启”，是立刻点） - 重启后，所有
.blade.php文件自动识别为Blade Template类型；输入@i就能出@if提示 - 常见错误：同时启用了 JetBrains 官方插件 + Victor Dubinin 的第三方
Laravel Plugin→ 冲突导致.blade.php被识别为 Plain Text
开启 Laravel 支持并指定项目根目录
{{ $user->name }} 不提示属性、User::find() 无法 Ctrl+Click 跳转，说明 PhpStorm 不知道模型类型，也没读取 config/app.php。
- 进
Settings → Languages & Frameworks → PHP → Laravel - 勾选
Enable Laravel support -
Application Path必须设为项目根目录（即含artisan和app/的目录），不能是子目录或空路径 - PHP 语言级别建议 ≥
8.1（Laravel 9+ 属性升级如public User $user;需要 PhpStorm ≥ 2022.3 才能识别） - 若已运行过
php artisan ide-helper:models，生成的_ide_helper_models.php会显著提升属性推导准确率
手动配置 Blade 视图路径才能跳转 @include
@include('partials.header') 按住 Ctrl + 左键点不进去？不是代码写错了，是 PhpStorm 根本没把 resources/views 当作视图根目录。
立即学习“PHP免费学习笔记（深入）”；
- 进
Settings → Languages & Frameworks → PHP → Blade → View Directories - 点
+添加路径，填resources/views（必须是相对路径，不能写/Users/xxx/project/resources/views） - 添加后，
@include补全会列出完整子路径，Ctrl+B 即可跳转；Alt+F7 可查被哪些模板引用 - 如果已有文件被手动覆盖过类型（比如右键 →
Override File Type设成了 Text），需重新右键 →Override File Type → Blade Template
Artisan 控制台报错 Class not found？检查解释器与路径
在 PhpStorm 内置 Terminal 或 Artisan Console 里执行 migrate 报 Class 'App\Console\Kernel' not found，本质是上下文加载失败。
- 进
Settings → Tools → Laravel → Laravel Artisan Console，勾选Enable Laravel Artisan console -
Artisan path必须指向项目根目录下的artisan文件（不是全局php artisan） - 确认 PHP interpreter 指向项目本地环境（如 Homestead、Valet、Docker Compose 解释器），而非系统默认旧版 PHP
- 若用 Docker，需在解释器设置中挂载
app/、config/等目录，否则类自动加载失败 - 改完
.env后 Artisan 不生效？删掉 Run Configuration 中手动填的Environment variables，让 Laravel 自己读
最常被忽略的其实是两件事：插件启用后不重启，等于没装；视图路径填了绝对路径，等于没填。其他所有问题，基本都卡在这两个点上。
