@once 的本质是确保 Blade 片段在单次请求中仅渲染一次,需配合 @push/@stack 才能实现 JS 去重;单独使用无效,且不跨视图共享,误用常见于 @section 内或未配对使用。

Blade @once 指令的本质作用
@once 不是为“避免重复加载 JS”而设计的,它只是让包裹的 Blade 片段在当前请求生命周期内只渲染一次。是否能避免 JS 重复执行,取决于你把它用在什么位置、怎么配合 标签使用——它本身不控制资源加载或执行逻辑。
@once 必须配合 @push / @stack 才能用于 JS 去重
单独写 @once 在模板任意位置不会自动去重 JS。真正起作用的组合是:@once + @push('scripts') + @stack('scripts')。Blade 的 @push 是队列式追加,@once 则确保同一段 @push 只进队一次。
- 如果多个组件都写
@push('scripts') @endpush,默认会重复入队 - 加上
@once后,即使该组件被 include 三次,也只 push 一次 -
@stack('scripts')放在布局底部统一输出,自然就只出现一次
@once
@push('scripts')
@endpush
@endonce
常见误用:直接在 @section 或普通位置写 @once
把 @once 写在 @section('content') 里,或者直接写在 blade 文件顶部,无法阻止 JS 重复——因为 @section 本身不参与输出时机控制,且 @once 只对当前渲染上下文生效,不跨视图层级共享状态。
-
@once的“一次”仅限于当前 Blade 编译/渲染过程,不是全局单例 - 父子视图中各自定义的
@once互不影响 - 若组件通过
@include被多次调用,每个@include是独立渲染,需在组件内部自己加@once - 若用
@component,则必须在组件类的render()方法里用 PHP 控制,@once在组件模板里仍按包含次数分别生效
比 @once 更可靠的方式:用 PHP 变量标记已加载
当逻辑复杂(比如依赖动态参数、需要条件判断),@once 容易失效。更可控的做法是在服务提供者或视图 Composer 中设置一个全局标记,再用 @if 控制:
@if (! isset($GLOBALS['js_chart_loaded'])) @php $GLOBALS['js_chart_loaded'] = true; @endphp @endif
注意:$GLOBALS 在 Laravel 请求生命周期中是稳定的;但不要用 static 属性或 app() 存储,因为视图渲染期间容器可能未完全初始化,且非线程安全。
真正容易被忽略的是:Blade 缓存机制会让 @once 的行为在 php artisan view:clear 后才重置,开发时改了逻辑却没清缓存,会导致你以为它“没生效”。










