自定义 TagLib 类必须继承 think\template\TagLib，类名以TagLib结尾、文件名与类名一致并置于app\taglib\目录下，命名空间为app\taglib；需重写tags属性声明支持的标签及属性；parse方法须返回可执行PHP代码字符串而非HTML；模板中使用前须用<load href="My"/>加载；开启缓存时需清除runtime/cache及runtime/log下文件。
自定义 TagLib 类必须继承 think\template\TagLib
不继承基类，模板引擎压根不会识别你的标签，调用时直接报错 Class not found 或静默忽略。ThinkPHP 6 的 TagLib 是严格约定的抽象结构，不是随便写个类放进去就能用。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 类名必须以
TagLib结尾（如TagLibMy），且文件名与类名一致，放在app\taglib\目录下 - 命名空间需为
app\taglib，否则自动加载失败 - 必须重写
tags属性数组，声明你支持哪些标签及其属性，例如：protected $tags = [ 'date' => ['attr' => 'format,timestamp', 'close' => 0], ];
parse 方法里不能直接 echo 或 return HTML 字符串
ThinkPHP 模板编译阶段要求你返回的是「可执行 PHP 代码字符串」，不是最终 HTML。很多人在这里卡住：写了 return '<span>'.date('Y-m-d').</span>'，结果页面原样输出那段字符串，或报语法错误。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
-
parse方法接收的是 XML 风格标签节点（如<my:date format="Y-m-d" timestamp="$time"/>），你要把它“翻译”成等效的 PHP 表达式 - 属性值要用
$this->autoBuildAttr($attrs)处理，避免未转义导致注入或语法错误 - 正确写法示例（生成
date('Y-m-d', $time)）：public function parse($tag, $content) { $format = $tag['format'] ?: "'Y-m-d'"; $timestamp = $tag['timestamp'] ?: 'time()'; return '<?php echo date(' . $format . ', ' . $timestamp . '); ?>'; }
模板中使用自定义标签前必须先 load 标签库
即使类已存在、路径正确，没在模板顶部声明，<my:date /> 这种写法会直接被忽略——不是报错，是彻底不解析，非常难排查。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在模板开头加：
<load href="My"/>
（My对应类名TagLibMy，不带后缀） - 如果标签库放在子命名空间（如
app\taglib\admin\TagLibAdmin），href要写成admin/Admin -
load只对当前模板生效，不能跨模板继承；多个标签库用逗号分隔：<load href="My,Date"/>
缓存开启时修改 TagLib 类不会立即生效
模板编译缓存默认开启，而 TagLib 的解析逻辑也被缓存进 runtime\cache\ 下的编译文件里。改了 parse 方法却看不到效果，八成是缓存没清。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 开发阶段建议关闭模板缓存：
'tpl_cache' => false加到config/template.php - 不清缓存时，要删掉
runtime\cache\和runtime\log\下所有文件（只删cache有时不够，日志里可能有旧编译痕迹） - 注意：CLI 命令行环境和 Web 环境的
runtime路径可能不同，别只清了一个
parse 返回的 PHP 代码字符串里变量作用域错乱、引号嵌套失衡，或者 load 路径大小写不匹配——Windows 不敏感，Linux 一跑就挂。这些地方没有报错提示，只有白屏或原始标签文本。 
