子模板变量覆盖问题本质是父视图传参键名与子视图变量名冲突，应通过加前缀、空值兜底、避免重定义同名变量及升级为组件来解决。
子模板变量覆盖问题，本质是父视图传参时键名与子视图中已有变量名冲突，导致意外覆盖或报错。关键不是“避免传参”，而是“控制传参方式和作用域”。
用明确键名 + 空值兜底，不依赖父变量直传
子视图默认拿不到父视图变量，必须显式传递。但若传参数组的键名恰好和子视图内部逻辑用的变量名相同（比如都叫 $items），而你又没做防御，就容易出问题。
- ✅ 推荐写法：
@include('list', ['list_items' => $data ?? []])—— 键名加前缀，语义清晰，几乎不会撞车 - ⚠️ 风险写法：
@include('list', ['items' => $data])，如果子视图里自己也写了$items = collect();，那传入的值就被覆盖了 - 传参时统一用
??提供默认值，防止undefined variable报错，例如：['title' => $title ?? '列表', 'empty_text' => $empty_text ?? '暂无数据']
子视图里别重定义同名变量
Blade 不是 PHP 脚本执行环境，但它仍会按顺序解析变量。一旦你在子视图顶部写 @php $message = 'hello'; @endphp，又恰好父视图传了 ['message' => 'error']，后者就会被前者覆盖（取决于谁先执行）。
- 子视图开头不主动声明变量，尤其避免用和传参键名相同的变量名
- 如需临时变量，加前缀或后缀，比如
$local_message、$tmp_data - 调试时可在子视图首行加
{{ dd(get_defined_vars()) }}，一眼看清哪些变量已存在、哪些被覆盖
需要复用父变量？用 with() 是错的，改用 compact 或重命名
@include('card')->with('title', 'xxx') 这种写法无效，@include 不支持链式调用，它会被当成字符串输出，不是语法错误但毫无作用。
- ❌ 错误：
@include('card')->with('title', $title) - ✅ 正确：用数组显式传参，或用
compact()（注意传字符串，不是变量）：@include('card', compact('title', 'items')) - 如果父视图变量名太泛（如
$data），建议在传参时重命名：@include('card', ['card_title' => $data['title'] ?? '', 'card_items' => $data['items'] ?? []])
复杂场景：用 @props 或组件替代 @include
当传参越来越多、子视图开始有状态或逻辑判断时，@include 就显得脆弱。这时更适合升级为匿名组件或具名组件。
- 运行
php artisan make:component Card，组件内通过@props(['title' => '默认标题', 'items' => []])声明参数，类型安全、IDE 友好、变量隔离天然成立 - 组件中
{{ $slot }}和命名插槽还能进一步解耦内容与结构，彻底避开变量覆盖风险 - 简单复用仍用
@include，但一旦出现“每次都要传七八个参数”或“子视图要判断是否显示某区块”，就是该换组件的信号
