@once 的本质是确保 Blade 片段在单次请求中仅渲染一次，需配合 @push/@stack 才能实现 JS 去重；单独使用无效，且不跨视图共享，误用常见于 @section 内或未配对使用。
Blade @once 指令的本质作用
@once 不是为“避免重复加载 JS”而设计的，它只是让包裹的 Blade 片段在当前请求生命周期内只渲染一次。是否能避免 JS 重复执行，取决于你把它用在什么位置、怎么配合 <script> 标签使用——它本身不控制资源加载或执行逻辑。
@once 必须配合 @push / @stack 才能用于 JS 去重
单独写 @once 在模板任意位置不会自动去重 JS。真正起作用的组合是：@once + @push('scripts') + @stack('scripts')。Blade 的 @push 是队列式追加，@once 则确保同一段 @push 只进队一次。
- 如果多个组件都写
@push('scripts') <script>console.log('x')</script> @endpush，默认会重复入队 - 加上
@once后，即使该组件被 include 三次，也只 push 一次 -
@stack('scripts')放在布局底部统一输出，自然就只出现一次
@once
@push('scripts')
<script>
console.log('init once per request');
// 这段脚本不管被多少个 @include 引入，最终只输出一次
</script>
@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'])) <script src="/js/chart.js"></script> @php $GLOBALS['js_chart_loaded'] = true; @endphp @endif
注意：$GLOBALS 在 Laravel 请求生命周期中是稳定的；但不要用 static 属性或 app() 存储，因为视图渲染期间容器可能未完全初始化，且非线程安全。
真正容易被忽略的是：Blade 缓存机制会让 @once 的行为在 php artisan view:clear 后才重置，开发时改了逻辑却没清缓存，会导致你以为它“没生效”。
