ThinkPHP6布局模板不渲染，先确认layout_on=>true等配置是否生效；必须用view()->fetch()而非display()；{:layout()}路径须相对template/且编码为UTF-8无BOM；修改后需清runtime/view/缓存。
布局模板内容不渲染，先确认 layout 配置是否生效
ThinkPHP6 默认不启用布局模板（layout），即使你在模板里写了 {:layout('layout@default')} 或在控制器里调用了 $this->view->engine()->layout('layout@default')，若全局配置未开启，所有 layout 指令都会被忽略——内容“丢失”其实是压根没执行。
检查 config/template.php 中是否存在以下配置项：
-
'layout_on' => true（必须为true） -
'layout_name' => 'layout'（默认值，但若你用了其他文件名如base.html，必须显式指定） -
'layout_item' => '{__CONTENT__}'（占位符必须与模板中实际写的完全一致，大小写、下划线数都不能错）
常见错误：把 {__CONTENT__} 写成 {__content__} 或 {%CONTENT%}，导致子模板内容无处插入，最终只输出 layout 文件本身，看起来像“内容丢失”。
fetch() 和 display() 混用导致 layout 被跳过
TP6 的视图引擎对调用方式敏感：只有 view()->fetch() 会触发 layout 渲染流程；而直接 view()->display() 是绕过 layout 的原始输出方式，哪怕配置了 layout_on 也无效。
立即学习“PHP免费学习笔记（深入）”；
典型出问题的场景：
- 控制器里写了
return view()->display('index');→ 布局不生效 - 模板中嵌套
{:include('header')}后又手动写了{:layout()}，但主模板仍用display()加载 → layout 不触发 - 使用了自定义中间件，在响应前调用了
Response::create(...)->send()，提前终止了视图生命周期
解决方法：统一用 return view()->fetch('index');，确保走完整视图管道。
模板路径或继承语法写错，layout 指令静默失败
TP6 的 {:layout()} 是编译期指令，不报错也不提示，路径错、文件不存在、语法格式不对时，它就当没这回事——子模板照常渲染，layout 部分彻底消失。
验证要点：
- 路径必须相对于
template/目录，例如{:layout('common/layout')}对应template/common/layout.html - 不能写相对路径如
{:layout('../layout')}，TP6 不支持向上跨目录解析 - 若使用命名空间写法
{:layout('layout@default')}，需确认config/template.php中'view_path'已正确定义 default 分组路径 - 模板文件编码必须是 UTF-8 无 BOM，BOM 会导致 layout 编译失败且无提示
快速验证：临时把 layout 文件内容复制到子模板顶部，看是否正常显示。如果能显示，说明问题 100% 出在 layout 加载环节，不是逻辑或数据问题。
缓存干扰导致 layout 变更不生效
TP6 模板编译缓存（runtime/view/ 下的 PHP 文件）会固化 layout 指令的解析结果。改了 {:layout()} 写法或 layout 文件内容后，若没清缓存，旧的编译结果仍被加载，看起来像“改了没用”。
注意：php think clear:cache 不清理模板编译缓存；必须手动删掉 runtime/view/ 全部内容，或执行：
php think clear:all
更隐蔽的情况：开发时开了 APP_DEBUG = true，但部署后忘了关，而生产环境又启用了 opcache —— 编译后的 layout 模板 PHP 文件可能被 opcache 缓存，连删 runtime/view/ 都不生效，需重启 PHP-FPM。
