ThinkPHP模板中{block name="xxx"}名称必须大小写完全一致，否则子模板区块内容被静默忽略、页面对应区域空白且不报错；底层采用严格字符串匹配，Content、CONTENT、content_等均不匹配，需统一小写+下划线并复制粘贴确保一致。
ThinkPHP模板中{block name="xxx"}的名称必须大小写完全一致，不是为了“好看”，而是底层匹配逻辑决定的硬性规则——名称不一致，子模板的区块内容就会被静默忽略，页面该区域直接空白，还不报错。
大小写不一致时，根本不会配对成功
ThinkPHP在编译子模板时，会逐个扫描{block}标签，提取name属性值（如"content"），然后去父模板中查找完全相同字符串的{block name="content"}。这里用的是严格字符串比对，Content、CONTENT、content_、mycontent全都不算匹配。一旦找不到，子模板里这个{block}就相当于不存在，内容不会渲染，父模板对应位置也维持原样（或为空）。
常见踩坑场景
- 父模板写
{block name="Header"}，子模板写{block name="header"}→ 不生效 - IDE自动补全把
sidebar变成SideBar→ 配对失败 - 复制粘贴时混入全角空格或不可见字符 → 名称看似一样，实则不同
- TP6+模板驱动对后缀敏感，
{extend name="public/base.html"}中路径大小写错，导致整个继承链失效，进而让所有{block}失去上下文
怎么确保名称一致
- 所有
{block name="xxx"}统一用小写字母+下划线（如"main"、"script"、"footer"），避免驼峰 - 在父模板定义后，复制
name值直接粘贴到子模板，不手动重输 - 开启调试模式（
app_debug = true），查看模板编译日志，确认是否出现block not found类提示（部分版本会隐式记录） - 使用编辑器高亮插件或自定义语法检查规则，对
{block}标签的name属性做字符串校验
大小写问题不只是block的事
它和ThinkPHP整体路径/类名机制一脉相承：Linux服务器区分大小写，Windows开发环境容易掩盖问题。模板{block}名称不一致，和控制器文件名写成usercontroller.php却声明class UserController是同一类问题——都是PSR-4与字符串精确匹配原则下的必然约束。
不复杂但容易忽略
立即学习“PHP免费学习笔记（深入）”；
