ThinkPHP中模板继承与layout布局本质不同：{extend}+{block}支持多层区块复用，layout仅单层{\_\_CONTENT\_\_}包裹；二者不可混用，{extend}须首行且路径/名称严格匹配。
ThinkPHP 中模板继承和 layout 布局不是一回事，但常被混用。真正实现“子页面复用结构+按需替换区域”的核心机制是 {extend} + {block}，而 layout 是另一套基于 {__CONTENT__} 的简单包裹逻辑。用错方式会导致内容不显示、继承失效或调试困难。
区分 layout 布局与模板继承
layout 是单层包裹：视图文件整体作为内容，插入到 layout.html 的 {__CONTENT__} 位置。它不要求写 {block}，也不支持区块级替换，适合全站统一头尾的极简场景。
模板继承是多层结构控制：父模板（如 base.html）用 {block name="xxx"} 定义多个可命名区块；子模板用 {extend name="base"} 声明继承，并只重写需要变动的 {block}，其余区块沿用父模板内容。这才是真正灵活的复用方式。
- 启用 layout 不影响 {extend} 使用，但二者不能混在同一模板中
- layout 配置项 'layout_on'=>true 仅对 layout 生效，{extend} 不依赖它
- 如果同时配置了 layout 且子模板又写了 {extend}，通常后者会失效或报错
正确使用 {extend} + {block} 的硬性规则
{extend} 必须出现在子模板第一行，前面不能有空格、空行、注释或输出；{block} 名称大小写和下划线必须与父模板完全一致；父模板中同名 {block} 必须存在，否则子模板对应内容直接被忽略（无报错，静默失效）。
立即学习“PHP免费学习笔记（深入）”；
- 父模板 base.html 示例：
{block name="title"}默认标题{/block}
{block name="header"}网站头部{/block}
{block name="content"}主内容区默认文本{/block} - 子模板 index.html 写法：
{extend name="public/base"}
{block name="title"}首页标题{/block}
{block name="content"}这里是首页具体内容{/block} - 若某区块不想修改，就别写该 {block}；若想保留父模板内容再追加，父模板中要写 {__BLOCK__}，例如：
{block name="script"}{__BLOCK__}<script>console.log('额外脚本');</script>{/block}
常见失效原因与排查步骤
页面只显示子模板内容、空白、或报 TemplateSyntaxError，大概率是路径或语法卡点。
- 检查 {extend name="xxx"} 的路径：它是相对于 view_path 的，比如 view_path 是 app/view/，那 "public/base" 对应的就是 app/view/public/base.html —— 后缀 .html 不能省（TP6 起强制要求）
- 确认父模板里至少有一个 {block}，且名称拼写完全匹配（比如 "footer" 和 "Footer" 视为不同）
- 清除 runtime\/temp\/ 下缓存文件，尤其改过配置或模板后，旧编译文件会干扰
- 子模板中不要出现两个同名 {block}，TP 按解析顺序取最后一个，前面的会被覆盖
进阶技巧：嵌套与组合复用
不需要所有内容都塞进 base.html。可把 header、nav、footer 单独抽成 include 文件，在父模板中用 {include} 引入，再用 {block} 包裹可变部分，兼顾清晰度与灵活性。
- base.html 中可以这样组织：
{include file="public/header" /}
{block name="nav"}{include file="public/nav" /}{/block}
{block name="content"}内容区{/block}
{include file="public/footer" /} - 子模板只需关注 {block} 替换，无需重复引入公共片段
- 避免在 {block} 内部再写 {extend}，ThinkPHP 不支持继承嵌套；如需多级抽象，建议用 {include} 分层组装
