先启用JetBrains官方Laravel插件并重启IDE，再配置Laravel支持、视图路径及自定义指令；否则@if等无提示、{{ $user->name }}不显示属性、@include无法跳转。
Blade 指令没提示？先确认 Laravel 插件已启用
PhpStorm 默认不带 Blade 支持，@if、@foreach 这些指令完全没补全、跳转或高亮，大概率是 JetBrains 官方 Laravel 插件没开。不是第三方“Laravel Plugin”，而是 Settings → Plugins 里搜索 Laravel 后显示作者为 JetBrains 的那个内置插件。
必须勾选启用，然后重启 IDE。重启后，所有 .blade.php 文件会自动识别为 Blade Template 类型，基础语法高亮和指令补全立刻生效。
常见错误：
- 同时启用了官方插件 + 第三方同名插件 → 冲突导致
.blade.php被识别为纯文本 - 插件开了但没重启 → 设置不生效
- 文件已存在且之前被手动覆盖过类型 → 右键该文件 →
Override File Type→ 选Blade Template
为什么 {{ $user->name }} 不提示属性？要配 Laravel 平台支持
Blade 中的 PHP 表达式（如 {{ $user->name }}）依赖 PhpStorm 对 Eloquent 模型的静态分析。没提示 ≠ 写错了，而是 IDE 不知道 $user 是什么类型。
立即学习“PHP免费学习笔记（深入）”；
关键操作：Settings → Languages & Frameworks → PHP → Laravel，勾选 Enable Laravel support，并确保 Application Path 指向你项目根目录（即包含 artisan 的目录）。
这样 PhpStorm 才能读取 config/app.php、扫描模型类、建立类型映射。如果项目运行过 php artisan ide-helper:models 并生成了 _ide_helper_models.php，属性提示会更准。
注意点：
- PHP 语言级别需 ≥ 7.4（Laravel 8+ 推荐），否则像
@props(['title' => ''])这类语法可能解析异常 - Laravel 9+ 使用 PHP 8.1 属性升级（如
public User $user;）时，PhpStorm 版本必须 ≥ 2022.3，否则无法识别类型注解 - 变量来自
@props或@inject时，IDE 推导能力有限，建议手动加 PHPDoc：/** @var \App\Models\User $user */
@include('xxx') 点不进去？得手动设置视图路径
@include、@extends、@component 中的模板名无法 Ctrl+Click 跳转，通常是因为 PhpStorm 没把 resources/views 当作视图根目录。
操作路径：Settings → Languages & Frameworks → PHP → Blade → View Directories → 点 + → 添加相对路径 resources/views（不能填绝对路径！）。
添加后，补全会列出子目录和完整模板名，Ctrl+Click 或 Ctrl+B 即可跳转。用 Alt+F7 还能快速查某个模板在全项目中被哪些地方引用。
补充说明：
- 如果项目用了非标准视图路径（比如
src/Views），也得在这里加进去 - 多个视图目录可叠加添加，顺序不影响功能
- 路径必须相对于项目根目录，IDE 不会自动推断
自定义 Blade 指令（如 @role）怎么加补全？
spatie/laravel-permission 这类包提供的 @role、@haspermission 等指令，PhpStorm 默认不认识，会导致无高亮、无补全、甚至标红警告。
配置入口：Settings → Languages & Frameworks → PHP → Blade → 切到 Directives 标签页 → 取消勾选 Use default settings → 点 Add。
以 @role 为例：
-
Name:role - 勾选
Has parameters -
Prefix:<?php if(\Spatie\Permission\PermissionServiceProvider::bladeMethodWrapper('hasRole', { -
Suffix:
结束指令（如 @endrole）不用单独配，只要配了开始指令，IDE 就能识别成一对。其他指令类似，只是把 hasRole 换成 hasPermissionTo、hasAnyRole 等对应方法名。
容易漏掉的细节：
- 前缀后缀里不要漏掉
{和—— 它们是占位符，会被 IDE 自动替换成实际参数 - 配完别忘了点右下角
Apply，否则不生效 - 如果指令含空格或特殊字符（如
@canany），名字就写原样，不要加@
Blade 支持真正起效的关键不在“配得多”，而在三处是否全部对齐：插件启用、Laravel 平台路径指向正确、视图目录注册到位。少一个，@include 跳转不了，{{ $model->xxx }} 提示不出来，自定义指令也白配。
