自定义标签原样输出的主因是框架未识别标签类：未继承think\template\taglib、类名不以taglib结尾、未置于app\taglib目录、命名空间非app\taglib、$tags未声明对应小写键名或parse方法未返回合法php代码。
ThinkPHP 7 中首页调用自定义标签库失败，绝大多数情况不是语法写错了，而是框架压根没识别你的标签类——它被当作文本原样输出，连报错都没有。
为什么自定义标签在首页原样显示（如
这是最典型的失效现象，根本原因在于 ThinkPHP 7 的模板引擎在编译阶段就跳过了你的标签，因为它不满足「可加载」的硬性条件：
- 类没继承
think\template\TagLib—— 缺这个，框架直接忽略整个类文件 - 类名不以
TagLib结尾（比如叫MyTag或TagLibMy不行，必须是TagLibMy），或文件名不匹配（TagLibMy.php≠MyTagLib.php） - 没放在默认路径
app\taglib\下，或命名空间不是app\taglib -
$tags属性里漏声明了该标签，比如写了<date></date>，但$tags数组里没有'date'这个 key（注意：全小写，大小写敏感）
为什么
<load href="My"></load> 是强制注册标签库的指令，但它只在当前模板生效，且依赖前置条件全部满足：
- href 值（这里是
My）必须和你的类名前缀一致：类叫TagLibMy→ href 写My；类叫TagLibDateHelper→ href 得写DateHelper - 如果类已存在但未被自动加载，
<load></load>会静默失败（不会报错，但后续所有<xxx></xxx>都不解析） - 首页模板（如
index.html）若启用了视图缓存，改完<load></load>后必须清空runtime/view/，否则仍在执行旧编译结果
parse() 方法返回值错导致页面白屏或 PHP 报错
ThinkPHP 7 的 parse() 方法不是让你拼 HTML，而是生成一段合法、可执行的 PHP 代码字符串：
- 错误写法：
return '<span>' . date('Y-m-d') . '</span>';→ 模板里直接输出这串字符串，或因单双引号嵌套崩掉 - 正确写法：用
$this->autoBuildAttr($attrs)处理属性，返回类似'<?php echo date("Y-m-d", $time); ?>'的字符串 - 属性值不能裸写，比如
$tag['format']是原始字符串，要转义成 PHP 字面量：$format = $tag['format'] ?: '"Y-m-d"';（注意加引号） - 别在
parse()里echo、dump()或调用view()，这些都会破坏编译流程
ThinkPHP 7 特有的兼容性坑点
TP7 对标签库的加载和解析逻辑比 TP6 更严格，几个容易被忽略的细节：
- TP7 默认关闭了「非标准标签库自动发现」，意味着你不能靠配置项启用任意目录下的 TagLib，必须严格落在
app\taglib\且命名规范 - 如果首页用了多层嵌套（比如
<list><item></item></list>），需确保$tags中对应标签的'close' => 1，否则闭合标签会被丢弃 - TP7 的模板编译器对 XML 标签的 namespace 前缀更敏感：
<date></date>中的my必须和<load href="My"></load>的href完全一致（大小写、有无下划线） - 调试时别只看浏览器输出，直接打开
runtime/view/下对应模板的缓存 PHP 文件，搜my:date—— 如果那里还是原样标签，说明根本没进parse()；如果看到echo date(...)但执行报错，问题就在返回的 PHP 字符串语法上
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
