必须安装 Laravel Plugin 才能识别 Blade 语法和路由，否则 .blade.php 文件仅显示 PHP 高亮，@if 等指令不补全、@include 无法跳转、Route::get 中的路径也无法导航至控制器；安装后需在设置中启用并验证右下角显示“Laravel”字样。
必须装 Laravel Plugin 才能识别 Blade 和路由
没装这个插件，resources/views 里的 .blade.php 文件就是纯 PHP 语法高亮，@if、@foreach 不补全，@include 点不进去，Route::get 里的字符串路径也跳不到对应控制器。这不是配置问题，是功能缺失。
安装方式只有两种：Settings → Plugins → 搜索 Laravel Plugin → Install → Restart IDE；或者手动下载 ZIP 包后通过 Install Plugin from Disk… 加载。注意作者名是 Victor Dubinin 或 JetBrains 官方认证标识，别装错第三方仿品。
- 装完必须进
Settings → Other Settings → Laravel Plugin勾选Enable Plugin for this Project - 重启后看右下角状态栏有没有显示
Laravel字样，没有说明没启用成功 - 如果项目不是标准结构（比如
app/不在根目录），需要手动指定App path和Config path
barryvdh/laravel-ide-helper 不是可选项，是 Eloquent 提示的刚需
只装 Laravel Plugin，User::find() 能跳转，但 $user->posts()->whereActive()->get() 里 whereActive() 依然没提示——因为这是动态方法，IDE 静态分析不到。这时候必须靠 barryvdh/laravel-ide-helper 生成元数据。
执行顺序不能乱：
立即学习“PHP免费学习笔记（深入）”；
- 先运行
composer require --dev barryvdh/laravel-ide-helper - 再运行
php artisan ide-helper:generate（生成_ide_helper.php） - 再运行
php artisan ide-helper:models（给每个模型加注释） - 最后运行
php artisan ide-helper:meta（生成.phpstorm.meta.php，让 Facade 方法可跳转）
常见坑：ide-helper:models 默认只处理 app/Models 下的类，如果你模型放在 app/Entities，得加参数 --dir=app/Entities；另外生成的 _ide_helper.php 文件要确保被 PhpStorm 索引（别加到 .gitignore 里就不管了，得确认它出现在 Project 视图中）。
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
自定义查询构建器方法不提示？@mixin 是唯一解
当你重写 newEloquentBuilder() 返回自定义构建器类时，比如 PostQueryBuilder 里写了 wherePublished()，即使 ide-helper 全量生成，PhpStorm 仍不会把这方法挂到 Post::query() 返回值上。
解决方法是在模型类顶部加 PHPDoc 注释：
/** * @mixin \App\Builders\PostQueryBuilder */ class Post extends Model
注意三点：
-
@mixin后面必须是完整命名空间路径，不能用use别名 - 这个注释必须紧贴
class声明上方，中间不能有空行 - 如果构建器类本身继承了
Builder，且你希望它也带上父类方法提示，就得确保父类也被正确索引（一般没问题，除非父类在 vendor 里且未开启索引）
artisan 命令在 PhpStorm 里直接运行失败？检查解释器和工作路径
点 Tools → Run Command… 输入 migrate 报错 command not found 或 PHP Fatal error，大概率是两件事没配对：
- PHP 解释器路径不对：进
Settings → PHP，确认Interpreter path指向的是你项目实际用的 PHP 版本（比如/opt/homebrew/bin/php，不是系统自带的/usr/bin/php） - Artisan 工作目录错了：在
Run → Edit Configurations里新建一个PHP Script类型配置，Script path填artisan，关键是要把Working directory设为项目根目录（含artisan文件的那个目录），否则 Composer autoloader 找不到类
顺带一提：artisan 命令面板默认不加载环境变量，如果本地 .env 里有特殊配置（比如数据库密码带特殊字符），建议改用 Terminal 标签页执行更可靠。
