迅睿CMS列表页不显示内容？手把手教你5分钟排查解决

你是不是昨天熬到两点改迅睿CMS的模板？

本来以为改完就能上线，结果刷新列表页直接傻了。

要么整个内容区空白，要么只有头部底部，内容一条都出不来。

百度搜了半小时，要么是五六年前的老版本教程，要么是一堆看不懂的专业术语，照着改完反而更乱。

别慌，今天这篇全是大白话操作步骤，你照着做，最快5分钟就能解决问题，不用花钱找技术。

1 先查最容易搞定的后台配置问题

80%的列表不显示问题，都是后台配置错了，改两下就能好，别上来就改代码。

1.1 检查栏目绑定的内容模型对不对

这个是新手最容易踩的坑，很多人建栏目的时候随便选模型。

操作步骤：登录后台→栏目管理→找到出问题的栏目点编辑

看「内容模型」这一栏的选项，是不是和你发内容的模型一致。

举个例子，你建的是新闻列表栏目，结果绑定了单页模型。那这个栏目本身就只能发一条内容，当然调不出列表。

要是模型错了，改成对应的模型就行，改完记得保存。

1.2 检查栏目访问权限有没有开

很多人测试的时候会设权限，上线忘了改，就会出问题。

操作步骤：栏目编辑页→切换到「权限设置」 tab

看「游客访问权限」这一项是不是打了勾，没打勾的话普通用户就看不到内容。

避坑提醒：你自己登着后台账号的时候，默认有所有权限，能看到内容。换个无痕窗口打开前台，才是普通用户的真实访问效果。

1.3 检查对应内容是不是已发布

要是你发内容的时候存了草稿，或者设了定时发布，前台肯定调不出来。

操作步骤：内容管理→选择对应栏目，看内容的状态列

状态要是「已发布」才会在前台显示，草稿或者未审核的内容都出不来。

2 再查模板调用代码有没有写错

要是后台配置都没问题，那大概率是你改模板的时候写错代码了。

2.1 核对列表标签的参数是否正确

迅睿调用列表的固定标签是{list}，参数错了肯定调不出内容。

给你放个最常用的正确调用代码，你对着改：

``` {list action=content catid=$catid num=10 order=updatetime desc}

{$t.title} {$t.updatetime|date='Y-m-d',}

{/list} ```

重点核对这两个参数：action必须是content，catid要么写$catid（调用当前栏目id），要么写你要调用的栏目实际id，别写错数字。

举个例子，你要调用id是3的栏目内容，结果catid写成13，当然啥都调不出来。

2.2 检查循环标签有没有闭合

很多人复制代码的时候，只复制了前面的{list}开头，漏了后面的{/list}闭合标签。

整个列表标签就会失效，要么页面空白，要么直接把代码显示在页面上。

你直接搜模板里的{list}，每个开头都对应找有没有{/list}，漏了补上就行。

2.3 核对调用的字段名是否正确

要是列表能出来，但是某一项内容是空的，那就是字段名写错了。

操作步骤：后台→内容模型→对应模型的「字段管理」

看你要调用的字段的英文名是什么，比如标题的英文名是title，时间是updatetime，你要调用产品价格，就找价格字段的英文名。

别自己瞎猜字段名，比如把标题写成{$t.name}，肯定显示不出来。

3 最后查缓存和伪静态配置

要是前面两项都没问题，那就是缓存或者URL规则的问题。

3.1 清空全站缓存再刷新

迅睿默认会缓存页面内容，你改了配置或者模板，没清缓存看到的还是旧内容。

操作步骤：点后台右上角的「清除缓存」→选择「全部缓存」→确认清除

别只清模板缓存，改了栏目配置或者URL规则，必须清全站缓存才有用。

清完之后开无痕窗口刷新页面，别用自己平时的浏览器，可能有本地缓存。

3.2 核对伪静态规则是否匹配

要是你开了伪静态，但是服务器上的规则不对，列表页要么404要么空白。

操作步骤：后台→系统设置→URL规则→点右上角的「导出规则」

你用的是apache就导出.htaccess文件，用nginx就导出nginx规则。

把规则上传到网站根目录，nginx的话还要把规则加到服务器配置里，重启服务才生效。

以上三个排查顺序，覆盖了90%的列表页不显示的情况。

你就按这个顺序来，先查简单的后台配置，再查代码，最后查缓存。

别上来就乱改模板代码，很多时候就是你忘了点发布，或者权限没开而已。

现在就去打开你的后台，按步骤排查，最快5分钟就能搞定。

要是排查完还是有问题，你把具体情况打在评论区，我看到就给你回复。