Typecho自定义字段深度玩法：让你的博客功能翻倍的实用技巧

52JinY 助手

用了Typecho好几年了，一直觉得它的自定义字段功能是个宝藏，但身边很多朋友要么不知道有这个东西，要么知道但不会用，实在可惜。今天就把我这几年摸索出来的一些经验整理一下，希望对大家有帮助。

先说最基础的。自定义字段在后台写文章的页面最下方，默认是隐藏的，很多新手根本不知道这里还有东西。你点开"自定义字段"那个折叠区域，就能看到可以添加键值对。键就是字段名，值就是你想存的内容。然后在主题模板里用 $this->fields->字段名 就能把内容输出出来。听起来简单，但玩法真的很多。

我最常用的一个场景是给文章设置封面图。很多主题虽然内置了封面图功能，但实现方式各有不同，而且如果你换主题就悲剧了。我自己的做法是统一用一个叫做 cover 的自定义字段存封面图的URL，然后在模板里判断这个字段有没有值，有就用，没有就显示默认图。这样换主题的时候，只要新主题也按这个规范来读取，数据完全不会丢。

另一个很实用的场景是给文章打"外链"标记。比如我有时候写的是转载或者推荐别人的内容，需要在标题旁边加一个跳转到原文的链接。我就设置一个叫 sourceUrl 的字段，填上原始链接，然后模板里判断如果这个字段不为空，标题就渲染成外链，否则就是站内链接。整个逻辑非常清晰，也不需要动数据库结构。

说到这里要提醒一点，自定义字段的值在数据库里是以文本形式存储的，所以如果你想存的是结构化数据，比如一组配置项，可以考虑存JSON字符串，读取的时候再用 json_decode 解析。我之前做过一个项目，给每篇教程文章设置了一个 meta 字段，里面存了难度等级、预计阅读时间、所需工具这几个属性，打包成JSON一起存，前端读取之后再展示。效果非常好，而且数据管理起来也很方便。

还有一个很少人提到的技巧，就是配合 Typecho 的钩子机制来批量操作自定义字段。如果你需要给大量文章统一加某个字段，手动一篇一篇加肯定不现实。可以写一个简单的插件，在 afterSave 钩子里做判断，如果文章不存在某个字段就自动添加默认值。这对做主题开发或者批量迁移数据特别有用。

最后说一个坑。自定义字段输出的时候一定要注意XSS问题。如果你的字段内容是用户可以控制的，输出到前端之前一定要做转义，用 htmlspecialchars 处理一下。我见过有人直接 echo $this->fields->xxx，然后字段里填了一段script标签，页面就中招了。虽然Typecho的后台本身有权限限制，但养成安全编码的习惯还是很重要的。

总体来说，Typecho的自定义字段是一个非常灵活的扩展机制，不需要改数据库，不需要装插件，就能实现很多个性化需求。用好了它，很多看起来需要专门开发功能的需求，其实几行模板代码就能搞定。有什么问题欢迎在下面讨论。