Blade组件需路径、命名、注册三者一致才能使用，否则报“Component not found”；匿名组件放resources/views/components/，带逻辑组件放app/View/Components/，文件名与标签名严格对应（如user-card.blade.php→<x-user-card>），类名和命名空间须正确；$attributes需手动合并class，$slot为HtmlString对象，判空须用toHtml()；具名插槽用{{ $header ?? '' }}；匿名组件轻量但无mount和依赖注入，复杂逻辑应选make:component；动态组件<x-dynamic-component>有安全、性能及类型推导缺陷，应避免滥用。
Blade组件不是“写完就能用”的东西，必须满足路径、命名、注册三者一致，否则 <x-alert> 标签直接报错 “Component not found”。
组件文件放哪、叫什么、怎么被识别
Laravel 只在两个位置找组件：一是 resources/views/components/ 下的 Blade 文件（匿名组件），二是 app/View/Components/ 下的 PHP 类（带逻辑组件）。两者不能混放——比如把 alert.blade.php 放进 components/ui/ 子目录，<x-alert> 就找不到。
文件名和标签名严格对应：
-
resources/views/components/user-card.blade.php→ 用<x-user-card>，不是<x-user_card>或<x-userCard> -
app/View/Components/Alert.php→ 类名必须是Alert，且命名空间为App\View\Components，否则类不生效 - 如果同时存在
Alert.php和alert.blade.php，Laravel 优先用类；删掉类后才 fallback 到纯视图组件
$attributes 和 $slot 怎么安全使用
$attributes 是组件接收 HTML 属性的唯一入口，比如 <x-button class="px-4" disabled>Click</x-button> 中的 class 和 disabled 都会进 $attributes。但它不会自动合并 class，得手动写：class="btn {{ $attributes->get('class', '') }}"。
$slot 是默认插槽变量，本质是 Illuminate\Support\HtmlString 对象，不是字符串：
-
{{ $slot }}可以直接渲染，但empty($slot)永远返回false，因为对象非空；要用trim($slot->toHtml()) === ''或@empty($slot->toHtml()) - 具名插槽如
<header>Title</header>，在组件内必须用{{ $header ?? '' }}或@isset($header){{ $header }}@endisset，旧语法$slot->header在 Laravel 9+ 已彻底移除 - 别在组件里对
$slot做str_replace或json_encode，它可能含未转义的 HTML，容易 XSS
什么时候该用 make:component，什么时候直接写 .blade.php
用 php artisan make:component Alert 的前提是你要用构造函数传参、做参数校验、或调用服务（比如查数据库、检查权限）。如果只是封装一个带 class 和文字的 div，匿名组件更轻量：
- 直接建
resources/views/components/tag.blade.php，内容就一行：<span class="tag {{ $type ?? 'default' }}">{{ $slot }} - 调用时
<x-tag type="warning">Deprecated</x-tag>，所有属性自动可用，无需写 PHP 类 - 但注意：匿名组件没有
mount()、不能注入依赖、无法处理复杂初始化逻辑 - 如果后续要加验证或状态管理，就得重构为带类的组件——别一开始为了省事选匿名，结果后期改不动
<x-dynamic-component> 不是万能的，别滥用
<x-dynamic-component :component="$name" :props="$data" /> 看起来灵活，但实际有硬限制：
-
$name必须是合法组件名（如"alert"），不能是运行时拼接的字符串（"user-".$role会报错） -
:props传的是数组，不是展开对象，所以['type' => 'error']可以，但$props里若含闭包或资源句柄会序列化失败 - IDE 和静态分析工具几乎无法推导动态组件的 props 类型，协作时容易出错
- 性能上比直接写
<x-alert>多一次字符串解析和类查找，高频列表渲染中差异明显
真正需要动态切换的场景很少，多数时候是设计没分层——比如用一个 <x-card> 组件配合 type 属性就够了，没必要拆成 x-card-default、x-card-hover 再动态选。
