排查步骤(从简到难)
第一步:检查基础设置(最常见原因)
这是新手最容易出错的地方,请务必仔细核对。

(图片来源网络,侵删)
-
检查字段是否已添加到模型中
- 进入后台:
[核心]->模型管理]。 - 找到你正在使用的模型(文章模型”),点击后面的
[字段管理]。 - 在字段列表中,确认你的自定义字段(
mytest)确实存在,并且状态为“是”,如果状态为“否”,请点击“编辑”将其改为“是”。
- 进入后台:
-
检查字段在“内容模型管理”中的勾选
- 在
模型管理]中,点击你正在使用的模型后面的[管理字段]。 - 你会看到所有已添加的字段列表,找到你的自定义字段,确保它被勾选了,显示”选项也是“是”。
- 在
-
检查字段在后台发布/编辑页面的位置
- 进入后台:
[核心]->[频道模型]->模型管理]。 - 点击你正在使用的模型后面的
[更改]按钮(不是字段管理)。 - 切换到
设置]标签页。 - 在“常规选项”或“其他选项”区域,检查你的自定义字段是否被勾选,并设置了正确的显示位置(内容下方”或“内容上方”)。
- 进入后台:
第二步:检查模板调用
如果基础设置都正确,那问题大概率出在模板文件上。

(图片来源网络,侵删)
-
检查标签语法是否正确
- DedeCMS 调用自定义字段的基本语法是:
{field:字段名}。 - 你的字段名是
mytest,那么在模板中就应该写成:{field:mytest}。 - 常见错误:
- 写成了
{dede:field.mytest}(这是错误的)。 - 写成了
{mytest}(在某些旧版本或特定场景下可能有效,但不推荐)。 - 字段名写错了,比如大小写不一致(
mytest和Mytest)。
- 写成了
- DedeCMS 调用自定义字段的基本语法是:
-
检查模板文件是否正确
- 确保你正在编辑的模板文件(如
article_article.htm)是与你发布的模型相匹配的。 - 如果你使用了“自定义模型”,请确保调用的是该模型对应的模板。
- 确保你正在编辑的模板文件(如
-
检查字段是否为空
- 在后台发布或编辑文章时,是否为该字段填写了内容?如果字段留空,前台自然显示不出来。
- 可以尝试在后台给该字段填入一个明确的内容(测试内容”),然后刷新前台页面看是否显示。
第三步:检查缓存问题
DedeCMS 有很强的缓存机制,有时修改了设置或模板后,缓存没有及时更新,导致看不到效果。

(图片来源网络,侵删)
-
清除所有缓存
- 进入后台:
[系统]->[系统基本参数]->[性能选项]。 - 点击底部的
[更新系统缓存]按钮。 - 也可以在
[系统]->[一键更新网站]中,勾选“更新HTML”和“更新缓存”,然后执行更新。
- 进入后台:
-
检查浏览器缓存
- 按
Ctrl + F5(Windows) 或Cmd + Shift + R(Mac) 强制刷新浏览器页面,清除本地缓存。
- 按
第四步:检查字段类型和权限
-
检查字段类型
- 有些字段类型(如
editor编辑器类型)需要额外的样式或JS文件支持,如果模板中没有正确引入,可能会导致显示异常。 - 检查你的字段类型是否与你的需求匹配,存储图片地址的字段,如果类型不是
image,你可能需要用{field:字段名}直接输出地址,并用<img src="{field:字段名}">来显示。
- 有些字段类型(如
-
检查用户组权限
- 进入后台:
[核心]->[会员管理]->[会员类型管理]。 - 检查当前登录的前台用户所属的用户组,是否有权限查看该自定义字段。
- 在
模型管理]->[更改]->[字段管理权限]中,可以设置不同用户组对该字段的浏览权限和投稿权限。
- 进入后台:
第五步:检查数据库和代码(进阶)
如果以上所有步骤都试过了还是不行,那可能是更深层次的问题。
-
检查数据库
- 进入你的网站数据库管理(如 phpMyAdmin)。
- 找到
dede_archives表(文章主表)和dede_addonarticle表(文章附加表,如果你的模型是“文章”)。 - 检查你的自定义字段名是否存在于
dede_addonarticle表中。 - 随便找一篇文章,看看该字段在数据库里是否有值,如果数据库里都没有,那问题出在字段添加或数据保存环节。
-
检查文件权限
- 确保你的模板文件(
.htm)和缓存目录(/data/)的文件权限是正确的,通常是 755 或 644。
- 确保你的模板文件(
-
检查代码冲突
- 检查你的模板文件中是否有其他错误的 PHP 或 DedeCMS 标签导致整个内容无法正常解析,可以尝试在一个全新的、最简单的模板文件中只写
{field:字段名}来测试。
- 检查你的模板文件中是否有其他错误的 PHP 或 DedeCMS 标签导致整个内容无法正常解析,可以尝试在一个全新的、最简单的模板文件中只写
总结与快速自查清单
遇到自定义字段不显示,不要慌,按这个清单过一遍:
- 后台设置:
模型管理]->[字段管理]-> 字段状态为“是”。 - 后台设置:
模型管理]->[管理字段]-> 字段被勾选且“显示”为“是”。 - 后台设置:
模型管理]->[更改]->设置]-> 字段被勾选。 - 后台发布:发布文章时,该字段。
- 前台模板:调用语法是否正确,应为
{field:字段名}。 - 系统缓存:后台
[性能选项]->[更新系统缓存],前台Ctrl + F5刷新。 - 数据库:检查数据库
dede_addonxxx表中字段是否存在并有值。
按照这个流程,99% 的自定义字段显示问题都能被解决,如果问题依旧,请提供更详细的信息,
- 你使用的 DedeCMS 版本(如 DedeCMS 5.7 SP2)。
- 自定义字段的具体名称和类型。
- 你在后台和前台分别是如何操作的。
- 报错的具体信息(如果有)。
