laravel组件必须用php artisan make:component生成，确保类命名空间、文件路径、blade标签名严格对齐；render()必须返回view()实例；属性绑定需加冒号；插槽变量须显式判空，构造函数参数不可缺失。
直接用 php artisan make:component 创建，别手写文件或放错路径——否则 <x-alert></x-alert> 会报 “View [components.alert] not found” 或类找不到。
组件必须用 Artisan 命令生成
手动在 resources/views/components/ 下建 alert.blade.php，或者在 app/View/Components/ 下手写 Alert.php，Laravel 都不会自动识别。只有运行命令才能确保：类命名空间、文件路径、Blade 标签名三者严格对齐。
-
php artisan make:component Alert→ 生成App\View\Components\Alert类 +resources/views/components/alert.blade.php - 类名必须首字母大写驼峰（
Alert），对应标签名必须小写中划线（<x-alert></x-alert>），大小写或分隔符错一个就失效 - 想分目录管理？用
php artisan make:component Forms/Input，它会生成Input.php和resources/views/components/forms/input.blade.php，调用时仍是<x-forms-input></x-forms-input>
render() 必须返回 view() 实例
Laravel 9+ 开始，render() 返回原始字符串（如 return '<div>...</div>'）会被静默忽略，组件内容不渲染，也不报错——这是最隐蔽的“白屏”原因。
- 正确写法：
public function render() { return view('components.alert'); } - 错误写法：
public function render() { return '<div class="alert">'.$this->message.'</div>'; } - 如果要用逻辑拼接 HTML，必须包装成
Illuminate\Contracts\Support\Renderable实现，但没必要——视图文件就是为此存在的
属性绑定必须加冒号，HTML 属性不能混用变量值
<x-alert type="error" message="{{ $msg }}"></x-alert> 这种写法是错的：message 是原生 HTML 属性，值不会被 Blade 编译，{{ $msg }} 会原样输出为字符串，不是变量值。
- 字面量传参：
<x-alert type="error" message="操作失败"></x-alert> - 变量传参必须加冒号前缀：
<x-alert :type="$alertType" :message="$msg"></x-alert> - 原生属性（如
id、class）可直接写，但含变量就得用:class；想透传所有属性？在组件类里声明public $attributes，模板中用{{ $attributes }}渲染
插槽变量不自动声明，{{ $header }} 会报 Undefined variable
命名插槽（比如 <x-slot name="header"></x-slot>）注入后，变量 $header 不是默认存在，没传就访问会直接报错，不是空字符串。
- 安全写法：
@isset($header){{ $header }}@endisset或{{ $header ?? '默认标题' }} -
$slot是HtmlString对象，empty($slot)永远为 false，判空得用trim($slot->toHtml()) === '' - 别用旧语法
$slot->header—— Laravel 9+ 已移除，只认$header变量名匹配
最常被忽略的是构造函数参数缺失导致的 ArgumentCountError：写了 public function __construct(public string $type, public bool $dismissible = false)，但调用时漏了 :type，错误堆栈指向视图编译器，根本看不出是 props 缺失。
