Laravel中标题逻辑不应混用$title props与$slot->first('h1')，因后者属实验性API且破坏slot语义；应明确区分结构化元数据（$title）与主体内容（$slot），优先强制title prop或使用命名插槽$header。
混用 $slot 和 props 时，标题逻辑别写成 fallback 到 slot
很多人会自然地想：「标题优先用 $title props，没传就从 $slot 里找第一个 <h1>」——但这是错的。Laravel 的 $slot 是整段内容的闭包容器，不是 DOM 查询器；$slot->first('h1') 属于实验性 API，文档未承诺稳定性，随时可能被移除或行为变更。
真正该做的是：明确语义边界——$title 是结构化元数据，$slot 是主体内容。两者不该互相 fallback。
- 如果组件需要标题，就强制要求
titleprop（或提供明确默认值），不要依赖解析 slot - 若允许用户自定义标题区域，应使用命名插槽如
$header，而非从$slot中“提取” - 避免在组件模板里写
{{ $title ?? $slot->first('h1') }}这类耦合逻辑
命名插槽变量名和 x-slot name 必须严格一致（含连字符处理）
Laravel 会把 x-slot name="card-footer" 自动转为驼峰变量 $cardFooter，但这个转换只发生在 Blade 编译期，且不支持所有边界情况。比如 name="user-id" → $userId 没问题，但 name="data-src" → $dataSrc 就容易和已有变量冲突。
- 推荐统一用小写字母+下划线命名插槽，如
name="card_footer"→$card_footer，避免隐式转换歧义 - 检查组件内是否已定义同名变量（比如
$footer和$footer插槽），否则会被覆盖 - 调用时漏写
name属性（如只写<x-slot></x-slot>）会导致内容进默认插槽，而非预期命名插槽
默认插槽内容不能被多个命名插槽“挤占”
当组件同时声明了 $slot 和多个命名插槽（如 $header、$footer），父级模板中所有未包裹在 <x-slot></x-slot> 里的内容，都会无条件进入 $slot ——哪怕你写了 <x-slot name="header">...</x-slot> 后还跟了一段裸文本，那段文本仍属于 $slot，不会自动分配到其他插槽。
- 常见错误：以为
<x-card><x-slot name="header">A</x-slot>B<x-slot name="footer">C</x-slot></x-card>中的B会进$body，实际它进的是$slot；组件里没显式输出$slot，B 就直接丢失 - 修复方式：组件模板中必须有
{{ $slot }}才能渲染裸内容；命名插槽变量（如$header）则需单独判断是否存在，例如@if(filled($header)) {{ $header }} @endif - 若想让 B 进入特定区域，必须显式包裹：
<x-slot name="body">B</x-slot>
插槽内容延迟执行，别在里面放耗时逻辑
$slot 和命名插槽变量本质是 PHP 闭包，在组件渲染时才执行。这意味着：每次调用组件，插槽内容都会重新编译并执行一次 —— 包括其中的数据库查询、循环、Blade 指令等。
- 禁止在
$slot内写@foreach($users as $user)或{{ $post->comments->count() }}，尤其当组件被循环多次时，性能会指数级恶化 - 正确做法：提前计算好结果，以变量形式传入，例如
<x-card :comments="$postComments"></x-card>，再在组件里用{{ $comments }} - 命名插槽同样适用此规则；
<x-slot name="actions">{{ $user->can('delete') ? '<button>删</button>' : '' }}</x-slot>这种写法会在每次渲染时重复判断权限
最易被忽略的点：插槽变量不是普通字符串，而是可执行的 Blade 片段闭包。它的存在本身就有开销，而它的内容又无法被 Blade 缓存机制自动优化——所以任何「看起来无害」的嵌套逻辑，都可能在高频渲染场景下变成瓶颈。
