ThinkPHP模板布局失效主因是{extend}未触发、父模板缺{block}、名称/路径不匹配或缓存干扰；{extend}须顶格首行无任何前置字符，TP6+需带.html后缀，路径相对view_path且大小写敏感，父模板必须存在同名{block}，否则子内容被静默丢弃。
ThinkPHP模板布局失效通常不报错，而是静默跳过继承逻辑，导致页面只渲染子模板内容、丢失公共结构。核心问题集中在继承未触发、父模板缺定义、名称或路径不匹配、缓存干扰这四类。
检查{extend}是否真正生效
{extend}必须严格位于子模板文件的**第一行第一个字符位置**，前面不能有任何内容：
- 不允许空格、空行、BOM头（用编辑器“显示所有字符”确认）
- 不能写在PHP注释之后，如<?php // 注释 ?>{extend name="layout"}会直接失效
- TP6+要求name值带.html后缀，例如{extend name="public/layout.html" /}
- 路径是相对于view_path配置项的，不是当前文件所在目录，大小写也敏感
确认父模板已正确定义{block}
子模板中的{block name="xxx"}要能覆盖，前提是父模板里存在同名且格式正确的声明：
- 父模板中必须有{block name="xxx"}...{/block}，不能漏写、拼错或大小写不一致（Content ≠ content）
- 名称中不能含特殊符号或空格，仅支持字母、数字、下划线
- 若父模板该区块为空，子模板内容仍会正常注入；但若父模板根本没这个{block}，子模板内容会被直接丢弃，无提示
验证布局功能是否启用及参数传递正确
ThinkPHP的layout不是全局开关，而是依赖具体调用方式：
- config('template.layout_on', true)只影响初始化，默认不作用于$this->fetch()
- 想启用继承，必须在子模板顶部写{extend}，不能只靠配置
- 动态切换布局需显式传参：$this->fetch('index', [], ['layout' => true, 'layout_name' => 'admin_layout'])，其中layout_name不含后缀和路径
- 关闭布局推荐用$this->fetch('index', [], ['layout' => false])，而非$this->view->engine->layout(false)（TP5.1+已移除）
清除缓存并验证最终输出
90%的“改了不生效”其实是缓存残留导致：
- 必须同时清空runtime/Cache/和runtime/Temp/两个目录（只删Cache无效）
- 查看浏览器源码：如果开头就是子模板的HTML，没有父模板的<html>或公共header，说明{extend}根本没执行
- 开启调试模式后，在日志中搜索think\template\driver\File::read，确认是否加载了layout文件；没出现即路径错误或文件不存在
