ThinkPHP模板标签不识别主因是缓存未彻底清理、自定义标签注册时机错误或类未被识别：须同时删除runtime/Cache和runtime/Temp目录，自定义标签类须继承\think\template\TagLib、命名以TagLib结尾、置于app/taglib/路径下且$tags数组正确定义。
ThinkPHP 模板标签不识别，90% 不是语法写错了，而是缓存没清干净、注册时机不对，或者自定义标签类压根没被框架加载进来。
删 runtime/view 和 runtime/temp 才算真清缓存
只删 runtime/view/ 下的文件远远不够。ThinkPHP 编译缓存分两层：runtime/Cache/ 存编译后的 PHP 文件，runtime/Temp/ 存模板哈希映射表（template_*.php）。如果只清 Cache，旧哈希还在，框架会跳过重新编译，继续执行已损坏的缓存文件。
- 开发环境务必同时删掉
runtime/Cache和runtime/Temp两个目录 - 别手动删某几个文件——缓存文件名带哈希，根本找不到全
-
php artisan view:clear对 ThinkPHP 无效，它没有这个命令 - 配置里设
'cache' => false（在config/view.php中）可临时绕过缓存，但不能替代清理
自定义标签不解析？先看类有没有被识别为 TagLib
写了 TagLib::add('mytag', MyTagLib::class) 却始终不生效，大概率是类本身没被框架识别为合法标签库。
- 类必须继承
\think\template\TagLib - 类名必须以
TagLib结尾（如MyTagLib），否则自动加载器会忽略 - 文件得放在默认路径：
app/taglib/MyTagLib.php（TP6 要求命名空间与路径严格匹配，比如namespace app\taglib;） -
$tags数组必须正确定义键名（全小写），没定义 = 解析流程直接跳过 -
parseXxx()方法不能返回 HTML 字符串，必须返回能被eval()执行的 PHP 代码片段
{volist} 嵌套报错或静默跳过？检查闭合和层级限制
嵌套标签出问题，往往不是语法错，而是解析器状态机卡住了。尤其注意 {volist} 和 {if} 混用时的变量作用域和闭合顺序。
立即学习“PHP免费学习笔记（深入）”；
-
{/volist}必须严格匹配开头的{volist}，不能混用{/foreach}或漏写 - id 属性值必须是合法变量名（不能含点、中划线），否则
$item.status可能被误拆成两个变量 - ThinkPHP 5.1+ 默认
template.taglib_level是 3，嵌套超深就静默跳过，不报错也不渲染 -
{switch}内部不能直接写{volist}，它不会报错，但子标签会被丢弃 -
{literal}区块内任何 ThinkPHP 标签都会原样输出，不再解析
模板里引用 header 却不解析变量？assign() 没传过去
用 include 或 load 引入 header.html 后，里面写的 {$title} 显示空白，不是标签坏了，而是控制器没把数据 assign 给它。
-
header.html是独立模板片段，不自动继承父模板变量 - 必须在控制器里显式调用
$this->assign('title', '首页')，再$this->display() - 如果 header 是通过
{include file="public/header"}加载的，变量仍需在当前 action 中 assign，不是“包含即共享” - 避免在 header 里写逻辑标签（如
{if}），复杂逻辑尽量前置到 PHP 层处理
最隐蔽的坑是：开发时开了 app_debug = true，上线后关了调试，缓存策略切换导致本地正常的模板在生产环境失效——这时候清缓存、查注册、验路径都得同步做，少一步都不行。
