迅睿内容管理系统标签调用不显示的全流程快速排查修复

第一步：基础信息前置确认，排除低级错误

先别急着查配置、动代码，70%的迅睿标签不显示问题都是基础信息不对造成的，按顺序逐项勾选确认：

• 标签所在模板是否启用生效：登录迅睿CMS后台→模板风格→当前使用风格右侧点击【使用】（如果已经启用，按钮会变成灰色“已使用”）
• 当前访问的URL是否对应正确的应用/栏目/页面：比如栏目页不能放在首页index.html调用，单页标签要先在后台内容管理→单页管理创建对应单页
• 标签语法是否完全符合迅睿CMS规范：注意必须用英文半角的{}包裹，不能写成中文全角的｛｝；标签名称和参数之间必须用空格分隔，不能用逗号或其他符号
• 是否开启了迅睿CMS的模板缓存：后台→系统设置→性能优化→查看“模板编译缓存”“数据缓存”是否开启，开启了的话先点击页面右上角的【清除缓存】→勾选所有缓存项→确认清除

第二步：标签格式与必填参数快速校验

如果基础信息没问题，接下来检查标签本身——迅睿CMS标签有严格的必填项要求，不同模块（比如文章、产品、单页）的必填参数不一样：

2.1 通用模块标签（以“文章模块module=news”为例）

完整且必填的通用模块列表标签代码如下，可直接复制后修改参数：

``` {module module=news num=10}

{$t.title}

{/module} ```

• module参数必须填写：对应后台内容管理→内容模型管理里的“标识”，不是“名称”（比如新闻模型标识通常是news，产品是product）
• 是否有返回数据：可以在标签外临时添加调试代码查看，修改后如下：

``` {module module=news num=10} {php var_dump($data);}

{$t.title}

{/module} ```

刷新页面如果看到array(0) { }，说明没有匹配到数据；如果看到其他内容，说明数据存在但显示有问题

2.2 单页标签

完整且必填的单页标签代码如下：

``` {page id=1} {$t.title} {/page} ```

• id参数必须填写：对应后台内容管理→单页管理里的“ID”列数字
• 同样可以用{php var_dump($data);}放在{page和{/page}之间调试

第三步：权限、状态、过滤条件等数据层排查

如果调试代码返回空数组，说明没有符合条件的数据，按以下顺序检查：

3.1 检查内容发布状态

登录后台→对应内容模块的内容列表→筛选“状态”为已发布，查看是否有内容；如果是审核模块，还需要确认“审核状态”为已通过

3.2 检查权限设置

• 模块权限：后台→用户管理→用户组管理→当前访问用户组（比如“游客”）→点击【内容权限】→勾选对应模块的“浏览权限”“内容列表权限”
• 栏目权限：后台→内容管理→栏目管理→对应栏目右侧点击【权限】→勾选当前访问用户组的“浏览权限”
• 单页权限：后台→内容管理→单页管理→对应单页右侧点击【编辑】→下拉找到“浏览权限”→勾选当前访问用户组

3.3 检查标签的过滤参数

迅睿CMS模块标签有很多过滤参数，比如catid（栏目ID）、field（字段过滤）、order（排序），如果参数设置错误会导致无数据：

• catid参数：如果填写了不存在的栏目ID，或者没有勾选对应栏目下的内容，会返回空；如果要调用所有栏目下的内容，可以删除catid参数
• field参数：如果填写了不存在的字段名，或者没有包含urltitle这些显示必需的字段，会导致无法显示；可以删除field参数默认调用所有字段
• order参数：如果填写了不存在的排序字段，会导致SQL错误，标签直接失效；默认可以删除order参数，按“发布时间倒序”显示

第四步：字段输出排查

如果调试代码返回了数据，但页面还是不显示，说明字段输出有问题：

4.1 检查字段名是否正确

• 模块字段名：后台→内容管理→内容模型管理→对应模型右侧点击【字段管理】→查看“字段名”列，不是“字段别名”
• 单页字段名：默认只有idtitlecontentkeywordsdescription，如果添加了自定义字段，同样在内容管理→单页管理→字段管理查看

4.2 检查字段是否有内容

调试代码里的$data会显示所有字段的内容，如果某个字段值为空（比如["content"]=> string(0) ""），说明后台没填写对应内容

4.3 检查富文本字段的输出方式

如果是富文本字段（比如content），直接输出{$t.content}会显示HTML标签，要显示格式化的内容需要用{$t.content|html_entity_decode}，如果还是不显示可以用{php echo htmlspecialchars_decode($t.content);}（注意调试后删除PHP标签）

第五步：自定义字段或特殊场景的额外排查

5.1 图片字段的输出

图片字段不能直接输出{$t.thumb}（如果是缩略图）或{$t.image}（如果是自定义图片字段），要添加域名前缀，完整代码如下：

``` {module module=news num=10}

{/module} ```

其中dr_get_file()是迅睿CMS内置的文件地址处理函数，会自动添加后台系统设置→附件设置里的“附件访问地址”前缀

5.2 时间字段的输出

时间字段默认输出时间戳（比如1720000000），要显示格式化的时间需要用{$t.inputtime|date='Y-m-d',}，其中inputtime是发布时间字段，Y-m-d是时间格式，可替换为Y年m月d日 H:i:s等

5.3 多语言版本的排查

如果是多语言版本，要确认：

• 当前访问的语言版本是否对应后台发布内容的语言版本
• 标签是否添加了lang参数，比如{module module=news lang=zh-cn num=10}

排查后的收尾工作

修复问题后，必须再次点击后台右上角的【清除缓存】→勾选所有缓存项→确认清除，然后刷新浏览器的强制刷新（Windows：Ctrl+F5；Mac：Cmd+Shift+R），确保显示最新的内容和模板