thinkphp的layout是视图层局部控制逻辑，非全局开关；关键在渲染入口、模板路径解析时机及{__content__}占位符严格匹配，配置或方法调用失效多因路径错误、大小写不符或未在fetch()中正确传参。
ThinkPHP 的 layout 不是全局开关，而是视图层的局部控制逻辑；直接改配置文件或调用 Layout() 方法都可能失效——关键在渲染入口和模板路径解析时机。
layout 配置项只在 fetch() 或 display() 时生效
ThinkPHP 5.1+ 中，layout 是 View 类的渲染参数，不是运行时状态。它只影响当前模板的「包裹行为」，不改变后续请求：
-
config('template.layout_on', true)仅初始化默认开关，实际是否启用由模板中{__CONTENT__}和当前模板路径决定 - 调用
$this->fetch('index')时，若index.html里没写{__CONTENT__}，即使layout_on=true也无布局嵌套 - 手动传参
$this->fetch('index', [], ['layout' => false])可临时关闭，但必须确保第三个参数是数组且键为layout
动态切换 layout 模板名必须用 layout_name 参数
默认 layout 模板是 layout.html，想按角色/设备/模块切不同布局（如 admin_layout.html、mobile_layout.html），不能靠变量赋值，得显式传参：
- 错误写法：
$this->assign('layout', 'admin_layout');——assign对 layout 无效 - 正确写法：
$this->fetch('index', [], ['layout' => true, 'layout_name' => 'admin_layout']) - 注意：
layout_name值不含扩展名，也不加路径前缀；文件必须放在template/[theme]/下，否则报错Template not found - 若用
view_replace_str替换了模板路径，layout_name仍以原始路径查找，不走替换逻辑
关闭 layout 的两种可靠方式
禁用 layout 不等于设 layout_on=false，因为该配置可能被控制器中间件或模板引擎初始化覆盖：
- 方式一（推荐）：渲染时强制关闭 ——
$this->fetch('index', [], ['layout' => false]) - 方式二：在模板顶部加
{% layout false %}（TP5.1+ 支持，注意是{%不是{） - 别用
$this->view->engine->layout(false)：5.1 后engine层已移除layout()方法，会抛出Call to undefined method - 如果用了
return $this->fetch()返回 JSON，layout 自动失效，但前提是没提前输出 HTML —— 一旦触发了 header 输出，再关 layout 也晚了
常见错误：layout 渲染空白或重复嵌套
现象是页面空、CSS 失效、或布局套了两层 layout.html，根本原因在路径和内容标记不匹配：
-
{__CONTENT__}必须全大写、双下划线、无空格；写成{__content__}或{=CONTENT=}都不会替换 - 子模板路径含子目录（如
user/profile）时，layout 仍从根template/下找，不会自动进user/目录搜layout.html - 开启
layout_on但子模板未调用fetch()（比如直接echo $this->fetch('xxx', [], [...])而没 return），可能导致输出缓冲混乱，部分 layout 内容丢失 - 使用
think-view独立扩展时，layout行为与核心 View 不完全一致，需检查其LayoutFilter是否启用
真正要动态切 layout，别碰配置文件和 assign，盯死 fetch() 的第三个参数；而 layout 文件本身，永远只认 {__CONTENT__} 这一个占位符——多一个空格，整个布局就塌掉。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
