{block}标签不生效通常因子模板未声明{extend}继承关系；子模板首行须为{extend 'layout.html'}，路径需准确且后无空格、bom或输出。
ThinkPHP模板继承中 {block} 标签不生效？先看是否漏了 {extend}
绝大多数 {block} 不渲染的问题，根本不是语法写错，而是子模板压根没声明继承关系。ThinkPHP 的模板继承是显式声明机制，不写 {extend} 就等于普通模板，{block} 直接被当纯文本输出。
常见错误现象：{block name="title"}默认标题{/block} 在页面上原样显示，而不是被替换或填充。
- 子模板第一行必须是
{extend 'layout.html'}（路径需准确，不支持相对路径简写如./layout） -
{extend}后不能有空格、BOM 或任何输出（包括 PHP 短标签前的空白） - 布局模板（如
layout.html）里必须有对应{block name="title"}...{/block}，且 name 完全一致（区分大小写）
子模板中 {block} 被忽略？检查是否用了 {/block} 闭合但没内容
ThinkPHP 的 {block} 是“覆盖式”而非“追加式”。如果子模板里写了 {block name="content"}{/block}（中间为空），它会把布局中同名 block 的全部内容清空，而不是保留默认值。
使用场景：你只想局部替换某一块，其他区域沿用布局默认内容——那就不能空写 block，得显式写出要替换的内容，哪怕只是 {block name="content"}{__CONTENT__}{/block}。
- 空
{block}标签 = 清空该区域，不是“跳过”或“保持原样” - 想继承布局中的默认内容，又想在子模板里加点东西？用
{__CONTENT__}插入原始内容，再前后补逻辑 - 不支持嵌套
{block}，多层继承时只认直接父模板里的定义
布局模板里 {block} 中调用 {widget} 或 {include} 渲染异常？注意变量作用域隔离
ThinkPHP 模板继承中，子模板的变量不会自动透传到布局模板的 {block} 外部区域，但 {block} 内部执行时，变量作用域是子模板上下文。这就导致一个典型坑：你在布局里 {block name="script"}{include 'common/js'}/{/block}，而 common/js.html 里用了 $user，但 $user 是子模板里 assign 的——它能访问；可如果 {include} 放在 {block} 外，就可能报 Undefined variable: user。
-
{block}内部共享子模板变量，外部则只认布局自身 assign 的变量 -
{widget}同理：widget 方法内部无法直接读取子模板变量，需显式传参，如{widget name="header" title="$title"} - 避免在布局模板的非 block 区域依赖子模板数据，否则容易在某些子模板未 assign 时出错
开启调试模式仍看不到 {block} 渲染过程？确认模板缓存是否屏蔽了变更
ThinkPHP 默认开启模板缓存，修改了 layout.html 或子模板的 {block} 结构后，旧缓存还在，导致你以为改了没生效。
性能影响：缓存开启时，模板编译只做一次；但开发期频繁调整 block 结构，缓存反而成为干扰项。
- 开发阶段建议关闭缓存：
'template' => ['cache' => false]（配置数组中设置） - 或者手动清空
runtime/template/目录下所有文件（别只删部分，ThinkPHP 缓存文件名含哈希，难定位） - 注意：Swoole 或 CLI 模式下，模板缓存可能常驻内存，需重启服务才能刷新
最麻烦的其实是嵌套继承 + 动态 extend 路径 + 模板编译错误混在一起时，错误提示往往指向错的文件。这时候别信第一行报错，先盯住 {extend} 是否真加载到了你认为的那个 layout。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
