模板中无输出，因未在顶部声明；标签库类须置于app/common/taglib/，命名TagLibMy、命名空间app\common\taglib、继承\think\template\TagLib，且需手动清除模板缓存。

模板中写 却没任何输出？不是报错，是直接被忽略——因为没在模板顶部用 声明标签库。这是最常被卡住的点，不是代码写错，是漏了这行声明。

必须在模板顶部显式加载标签库

ThinkPHP8 的自定义标签不会自动识别，哪怕类已注册、路径完全正确，只要模板里没这句，标签就等于不存在。

• 必须放在模板最开头（ 之前或紧贴其后），不能嵌在 里
• name 值必须和标签库类名后缀一致：类名是 MyTag，这里就填 my；类名是 NavTag，就填 nav
• 一个模板可加载多个，比如 ，用英文逗号分隔
• 如果用了 config/template.php 中的 taglib_pre_load 配置，仍需在模板中声明——它只预加载类，不自动启用解析

标签库类命名与位置必须严格匹配

ThinkPHP8 按固定规则查找标签库类，路径、命名、命名空间三者错一个， 就会静默失败。

• 类文件必须放在 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 数组不是随便写的配置，它直接控制模板里怎么写、能不能嵌套、属性怎么传。

PHP 8.5.12

修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

• key 名就是标签名：'date' => [...] 对应 ，不是
• 'attr' => 'format,tz' 表示只允许这两个属性，多传 class 或拼错 formate 会被忽略（无报错）
• 'close' => 0 表示自闭合标签，不支持子内容；'close' => 1 才能写 ... 这种闭合结构
• 需要嵌套子标签时，必须设 'level' => 2 或更高，否则内层标签不被解析（比如 ...）

tagxxx 方法返回的是 PHP 代码字符串，不是 HTML

别在 tagdate() 里直接 return '2026-05-09';，ThinkPHP 模板引擎要的是能插入到编译后 PHP 文件里的代码片段。

• 返回值必须是合法 PHP 语句组成的字符串，常见写法：''
• 若需访问模板变量（如 $user.name），得用 $this->tpl->get($name) 获取，不能直接读 $_vars
• 含子内容（$content）的标签，要把 $content 原样拼进返回字符串里，例如：'' . $content . ''
• 注意单双引号嵌套：属性值来自 $tag['format']，拼进字符串时要用单引号包裹，避免变量提前解析

最容易被忽略的是：标签库类修改后，模板缓存不会自动更新。改完 TagLibMy.php，必须手动删掉 runtime/template/ 下对应缓存文件，否则永远跑旧逻辑。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！