模板中无输出，因未在顶部声明；标签库类须置于app/common/taglib/，命名taglibmy、命名空间app\common\taglib、继承\think\template\taglib，且需手动清除模板缓存。
模板中写 <date></date> 却没任何输出？不是报错，是直接被忽略——因为没在模板顶部用 <taglib name="my"></taglib> 声明标签库。这是最常被卡住的点，不是代码写错，是漏了这行声明。
必须在模板顶部显式加载标签库
ThinkPHP8 的自定义标签不会自动识别，哪怕类已注册、路径完全正确，只要模板里没这句，标签就等于不存在。
-
<taglib name="my"></taglib>必须放在模板最开头（之前或紧贴其后），不能嵌在里 - name 值必须和标签库类名后缀一致：类名是
MyTag，这里就填my；类名是NavTag，就填nav - 一个模板可加载多个，比如
<taglib name="my,auth,page"></taglib>，用英文逗号分隔 - 如果用了
config/template.php中的taglib_pre_load配置，仍需在模板中声明——它只预加载类，不自动启用解析
标签库类命名与位置必须严格匹配
ThinkPHP8 按固定规则查找标签库类，路径、命名、命名空间三者错一个，<taglib name="xxx"></taglib> 就会静默失败。
- 类文件必须放在
app/common/taglib/目录下（非extend/或app/taglib/） - 类名必须是
TagLibXxx格式，比如TagLibMy、TagLibAuth，首字母大写，前面固定加TagLib - 命名空间必须是
app\common\taglib，不能省略app\，也不能写成think\template\taglib - 类需继承
\think\template\TagLib（注意大小写，不是taglib小写）
标签定义数组 $tags 的 key 和 attr 决定语法行为
$tags 数组不是随便写的配置，它直接控制模板里怎么写、能不能嵌套、属性怎么传。
- key 名就是标签名：
'date' => [...]对应<date></date>，不是<date></date> -
'attr' => 'format,tz'表示只允许这两个属性，多传class或拼错formate会被忽略（无报错） -
'close' => 0表示自闭合标签，不支持子内容；'close' => 1才能写<if>...</if>这种闭合结构 - 需要嵌套子标签时，必须设
'level' => 2或更高，否则内层标签不被解析（比如<list><item>...</item></list>）
tagxxx 方法返回的是 PHP 代码字符串，不是 HTML
别在 tagdate() 里直接 return '2026-05-09';，ThinkPHP 模板引擎要的是能插入到编译后 PHP 文件里的代码片段。
- 返回值必须是合法 PHP 语句组成的字符串，常见写法：
'<?php echo date("' . $format . '"); ?>' - 若需访问模板变量（如
$user.name），得用$this->tpl->get($name)获取，不能直接读$_vars - 含子内容（
$content）的标签，要把$content原样拼进返回字符串里，例如：'<?php if ($cond): ?>' . $content . '<?php endif; ?>' - 注意单双引号嵌套：属性值来自
$tag['format']，拼进字符串时要用单引号包裹，避免变量提前解析
最容易被忽略的是：标签库类修改后，模板缓存不会自动更新。改完 TagLibMy.php，必须手动删掉 runtime/template/ 下对应缓存文件，否则永远跑旧逻辑。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
