LaravelBlade模板引擎语法与技巧，有哪些基础长尾词用法？

本文共计1080个文字，预计阅读时间需要5分钟。

Blade 模板并非写法越多越好，而是通过几个核心机制就能覆盖95%的日常需求：

怎么命名和放对位置，view() 才不报 View not found

这是最常卡住新人的第一步——文件存在，但 Laravel 死活找不到。

• resources/views/ 是唯一被扫描的目录，app/Views/、public/views/、views/（项目根目录下）全都不认
• 文件名必须以 .blade.php 结尾，dashboard.php 或 home.html 不会被编译，view('home') 直接抛出 View [home] not found
• 子目录路径自动转为点号，resources/views/admin/users/index.blade.php 对应视图名是 admin.users.index，不是 admin/users/index
• 文件名不能含空格或中文，user list.blade.php → 改成 user_list.blade.php；否则 view('user list') 会解析失败

{{ $var }} 和 {!! $var !!} 的区别不只是“转义不转义”

它们本质是两种安全策略：一个默认兜底，一个主动担责。

• {{ $var }} 等价于 htmlspecialchars($var, ENT_QUOTES, 'UTF-8')，连 <script> 都会变成可见文本，防 XSS 是刚性保障
• {!! $var !!} 完全不处理，原样进 HTML，只该用于你 100% 控制来源的内容，比如后台富文本编辑器存的 <p><strong>Hello</strong></p>
• 常见错误：把用户提交的评论字段用 {!! $comment !!} 渲染 → XSS 漏洞直接暴露；或者把 JSON 字符串用 {{ $json }} → 输出一堆转义符号，前端 JSON.parse() 报错
• 需要传 JSON 给 JS 时，推荐：<script>const data = @json($data);</script>，@json 会自动转义并保证合法 JSON 格式

@extends 和 @section 配对失败的三个典型信号

页面空白、报 Undefined variable: __env、内容不显示但没报错——基本就是继承链断了。

• 父模板用 @yield('content')，子模板必须写 @section('content')，拼写、大小写、引号类型（单/双）全部严格一致；@section('Content') 或 @section("content") 都不会匹配
• @extends('layouts.app') 必须是子模板的第一条指令，前面不能有空行、注释、HTML 或 PHP 代码；否则 Blade 解析器会把 @extends 当作普通文本处理
• @section 必须配 @endsection，@stop 是旧写法（Laravel 5.8+ 已弃用），继续用会触发 E_USER_DEPRECATED 警告，某些调试模式下直接中断渲染
• 想在子模板里“追加”而不是“替换”某段内容（比如往 styles stack 加 CSS），用 @push('styles') + @stack('styles')，别反复写 @section('styles')，后者只会覆盖前一次

循环里用 $loop 变量比手动计数更可靠

别在 @foreach 外套一层 $i = 0; $i++，Blade 自带的 $loop 更简洁、线程安全、且支持嵌套循环独立追踪。

• $loop->index：从 0 开始的当前索引（等价于传统 for 循环的 $i）
• $loop->iteration：从 1 开始的当前轮次（更符合“第几条”的语义）
• $loop->first / $loop->last：布尔值，不用再写 $loop->index === 0 或 $loop->index === count($items) - 1
• 嵌套循环中，每个 @foreach 有自己的 $loop 实例，$loop->parent->first 可访问外层循环状态
• 注意：$loop 在 @forelse 的 @empty 分支里不可用，因为此时没有实际循环发生

Blade 编译缓存很省心，但改完模板后页面没更新，第一反应不该是“是不是语法错了”，而是先清缓存：php artisan view:clear —— 尤其在生产环境或启用了 OPcache 时，旧编译文件可能顽固驻留。