Typecho自定义字段开发，扩展博客功能
Typecho 默认只提供标题、正文、分类等基础字段，想给文章加个“封面图”“下载按钮”或“视频地址”，就得靠自定义字段。本文面向零基础用户，从字段注册到模板调用完整走一遍，看完就能给自己的博客加上任意扩展内容。
## 动手前需要准备什么
- 一个可编辑的 Typecho 主题，建议先用官方默认主题 `default` 测试，避免改坏线上主题。
- 服务器上能通过宝塔面板或 SSH 访问网站目录，文件路径一般是 `/www/wwwroot/你的域名/usr/themes/你的主题/`。
- 基础的 PHP 阅读能力即可，不需要写复杂逻辑。
- 备份 `functions.php` 和 `post.php`，改错了可以随时还原。
## 注册字段：让后台出现自定义输入框
Typecho 的自定义字段通过主题的 `functions.php` 挂载。打开当前主题目录，在 `functions.php` 末尾添加以下代码：
```php
function themeFields($layout) {
$cover = new Typecho_Widget_Helper_Form_Element_Text(
'cover', null, null,
_t('封面图'), _t('填写图片URL，留空则不显示')
);
$layout->addItem($cover);
$download = new Typecho_Widget_Helper_Form_Element_Text(
'download_url', null, null,
_t('下载地址'), _t('按钮跳转链接')
);
$layout->addItem($download);
}
```
保存后进入后台“撰写文章”页面，右侧或下方会出现“自定义字段”折叠区，里面就是刚注册的封面图和下载地址。
如果想加多行文本，把 `Typecho_Widget_Helper_Form_Element_Text` 换成 `Typecho_Widget_Helper_Form_Element_Textarea` 即可。字段名统一用小写字母加下划线，避免中文和特殊符号。
## 在文章模板里调用字段值
字段注册好只完成一半，还要在主题的 `post.php` 或 `index.php` 中把值取出来。常用写法：
```php
fields->cover; ?>
" alt="title(); ?>">
```
下载按钮同理：
```php
fields->download_url; ?>
" target="_blank">点击下载
```
注意 `$this->fields->字段名` 中的字段名必须和注册时第一个参数完全一致。输出 URL 时建议用 `htmlspecialchars` 过滤，防止 XSS。
## 容易踩坑的几个地方
**字段不显示**：先确认代码加在了当前启用主题的 `functions.php`，而不是其他主题。改完文件后到后台“控制台-外观”重新保存一次主题设置，让配置刷新。
**值取不到**：检查字段名拼写，PHP 变量名区分大小写。另外自定义字段的值存在 `typecho_fields` 表里，如果手动改过数据库结构可能导致读取失败。
**多个字段冲突**：不要注册同名字段，否则后注册的会覆盖前者。
**安全问题**：所有输出到 HTML 的字段值都要转义，尤其下载地址和图片地址，避免被注入恶意脚本。
## 验证是否生效
发布一篇测试文章，在自定义字段区填入图片 URL 和下载链接，前台打开文章页。如果封面图正常显示、按钮能跳转，说明字段开发成功。若图片不显示，右键查看元素确认 `src` 是否为空；若按钮无链接，检查 `href` 是否被转义成了空值。
建议先在本地或测试环境跑通，再同步到线上主题。Typecho 自定义字段开发本质上就是“注册字段-调用字段”两步，掌握后可以扩展出评分、价格、视频嵌入等任意功能。
