@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 后才重置，开发时改了逻辑却没清缓存，会导致你以为它“没生效”。

# php  # laravel  # js  # composer  # app  # Static  # if  # include  # 线程