删除PHP类文件后需执行php artisan view:clear和composer dump-autoload清除Blade编译缓存与类映射，否则因缓存残留导致“failed to open stream”错误；匿名组件仅需.blade.php文件，路径为resources/views/components/[name].blade.php，命名转标签时小写并用短横线分隔。
删除 PHP 类文件后直接用 <x-icon></x-icon> 会报 “failed to open stream” 错误，不是组件写错了，是缓存和自动加载没清干净。
匿名组件到底长什么样
匿名组件就是只有 Blade 文件、没有对应 PHP 类的组件。它不继承 Illuminate\View\Component，也不需要 make:component 命令生成类文件。
- 视图路径必须是
resources/views/components/[name].blade.php（如resources/views/components/button.blade.php） - 文件名转标签名时全部小写、用短横线分隔：比如
user-card.blade.php→<x-user-card></x-user-card> - 支持
@props声明属性、{{ $slot }}渲染插槽、{{ $attributes }}合并外部 HTML 属性 - 不支持构造函数参数注入或类型提示——所有传入值都靠 Blade 指令解析
为什么 <x-xxx></x-xxx> 找不到类还报错
Laravel 在首次编译含组件标签的模板时，会把“类名推导逻辑”硬编码进 storage/framework/views/ 下的 PHP 缓存文件；同时 Composer 的 autoload_classmap.php 若仍记录已删类路径，运行时就会尝试 include 一个不存在的文件。
- 错误典型信息：
include(/path/to/app/View/Components/Button.php): Failed to open stream -
php artisan cache:clear不管用——它不清 Blade 编译缓存 -
composer dump-autoload必须执行，否则自动加载器仍会查已删类 - 若项目启用了
--classmap-authoritative，漏掉这步会直接 fatal error
怎么安全地从类组件切到匿名组件
不能只删 PHP 文件就完事。四步缺一不可，顺序也不能乱：
- 删掉对应的 PHP 类文件，例如
app/View/Components/Button.php - 确认
resources/views/components/button.blade.php存在且内容正确 - 运行
php artisan view:clear—— 强制重建所有 Blade 编译缓存 - 运行
composer dump-autoload—— 刷新类映射，移除对已删类的引用
漏掉最后两步中的任意一个，都可能在下次请求时触发文件包含失败。
什么时候该用匿名组件而不是类组件
匿名组件适合结构固定、逻辑极轻、不需要服务容器解析或复杂初始化的 UI 片段。
- 图标、按钮、徽章、空状态提示这类纯展示型元素
- 团队协作中希望降低组件上手门槛（不用理解 PHP 类生命周期）
- 快速原型阶段，先用 Blade 写死再逐步抽离逻辑
- 注意：如果组件需要依赖注入（如
Auth、Request）、条件渲染大量业务逻辑、或需复用 Eloquent 查询，还是得回到类组件
真正容易被忽略的是：Blade 编译缓存和 Composer 类映射是两个独立系统，出问题时表现相似但修复手段完全不同。
