Blade 模板编译为原生 PHP 缓存执行,文件须置于 resources/views/ 下并用点号命名;@extends 必为首行,@section 需配对闭合;{{ }} 自动转义防 XSS,{!! !!} 仅限可信 HTML;传参推荐数组方式,缓存路径为 storage/framework/views/。

Blade 不是运行时解释的模板,而是编译成原生 PHP 代码后缓存执行的——这意味着你写的是 .blade.php,Laravel 实际运行的是它生成的 PHP 文件。只要文件没改,后续请求直接执行缓存,零额外开销。
视图文件怎么放、怎么命名
所有 .blade.php 文件必须放在 resources/views/ 下,否则 view() 找不到。
子目录用点号映射:比如 resources/views/admin/users/index.blade.php,调用时写 view('admin.users.index');不能写成 view('admin/users/index') 或加 .blade.php 后缀。
常见错误:view('layouts.app') 写成 view('layouts/app') ——会报 View [layouts/app] not found。
@extends 和 @section 必须配对且位置正确
@extends 必须是子视图的第一行(前面不能有空格、注释或 HTML),否则 Laravel 解析失败,报错 Undefined variable: __env 或直接白屏。@section 必须闭合:@endsection 缺失会导致整个页面渲染中断,且错误不明显(可能只显示部分内容)。@yield('content') 在布局里可以带默认值:@yield('content', '默认内容'),但 @section('content') 在子视图里不能带默认值——那是 @yield 的事。
想在子视图中追加而非覆盖父级 @section,必须用 @parent,例如:@section('sidebar')@parent<p>新内容</p>@endsection。
{{ }} 和 {!! !!} 的安全边界在哪
{{ $user->name }} 自动调用 htmlspecialchars(),防 XSS,适合绝大多数输出场景。{!! $html_content !!} 直接输出未转义 HTML,仅限你**完全信任该变量内容**时使用(比如 CMS 管理员编辑过的富文本)。
常见坑:{{ $user->bio }} 如果 bio 是用户输入的 HTML,会被转义成纯文本;但若误用 {!! $user->bio !!},又没做过滤,就可能执行恶意 script。
别试图用 {{ html_entity_decode($str) }} 绕过转义——Blade 不支持在双花括号里调用函数解码,会报 Undefined variable 或直接输出字符串字面量。
传数据给视图的三种写法差异
控制器里传参,这三种都合法,但语义和可维护性不同:
• 数组方式:return view('profile', ['name' => $name, 'posts' => $posts]); ——清晰,推荐用于少量变量
• compact():return view('profile', compact('name', 'posts')); ——要求变量名和键名一致,少打字但易出错(比如变量没定义就 compact('missing_var'),会抛 Undefined variable)
• 链式 with():return view('profile')->with('name', $name)->with('posts', $posts); ——适合动态拼接,但嵌套多层时不如数组直观
注意:with() 传入的键名不能含点号(如 with('user.name', $value) 无效),而数组方式可以:['user' => ['name' => $name]],模板里用 {{ $user['name'] }} 或对象访问(如果 $user 是对象)。
立即学习“PHP免费学习笔记(深入)”;
Blade 编译缓存路径是storage/framework/views/,出问题时删掉这个目录能强制重编译——但别在生产环境随便删,除非确认是缓存损坏。真正难调试的,往往是布局继承层级太深、@section 拼写不一致(比如父级写 @yield('contnet') 拼错),或者 @include 的路径错了却没报错(因为 Blade 默认静默忽略不存在的 include)。



















