必须启用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 当作视图根目录。
- 进
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 自己读
最常被忽略的其实是两件事:插件启用后不重启,等于没装;视图路径填了绝对路径,等于没填。其他所有问题,基本都卡在这两个点上。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











