自定义模板标签未注册导致原样输出或报错，需确保路径、命名空间、类名三者严格匹配psr-4规范，继承taglib并定义小写tags属性，模板中用显式加载，清除缓存或关闭模板缓存。
TP 8.1.0 中自定义模板标签未注册，最直接的表现是标签原样输出（如
确认类文件路径与命名空间严格匹配
ThinkPHP 8.1 沿用 PSR-4 自动加载规范，路径即命名空间。必须满足三者一致：
- 文件物理路径为 app\taglib\MyTagLib.php（Windows）或 app/taglib/MyTagLib.php（Linux/macOS）
- 类名必须以 TagLib 结尾，例如 class MyTagLib
- 命名空间声明必须为 namespace app\taglib;（不能多一级如 app\taglib\admin，也不能少一级）
确保标签类继承基类并声明 tags 属性
没有继承 think\template\TagLib，框架会跳过整个类；没有定义 $tags 数组，即使类加载成功，标签也不会进入解析流程：
- 类开头必须写：use think\template\TagLib; 并 extends TagLib
-
protected $tags = ['hello' => ['attr' => 'name', 'close' => 1]];必须存在，且键名全小写（'Hello'或'HELLO'均无效） - 属性名大小写敏感，
attr里写的'format,timestamp'，模板中就必须用format和timestamp，不能写成Format
在模板中显式加载，不可省略
TP 8.1 不再支持全局自动注册，每个模板需手动声明所用标签库。即使类已放对位置、命名空间正确，没这行就等于没注册：
- 在模板顶部（
{extend name="public/base"}后、任何内容前）添加： -
href="My"对应类名MyTagLib（去掉TagLib后缀） - 若类在子目录如
app\taglib\admin\Admintaglib.php，命名空间为app\taglib\admin，则写
检查运行时缓存是否阻断新注册
模板引擎会把标签解析逻辑编译进缓存文件。旧缓存未清除，会导致新加的 <load></load> 被忽略，或仍按旧规则解析：
- 删除 runtime\cache\ 和 runtime\view\ 下全部内容（不是只删某个文件）
- 开发阶段建议临时关闭模板缓存：在
config/template.php中设 'cache' => false - 避免在控制器或中间件里调用
TagLib::add()—— TP 8.1 的模板编译器初始化早于请求生命周期，此时注册已失效
