小白都能秒懂的迅睿CMS标签参数错误修正

1. 先搞懂：90%的人犯的都是这3类错误

昨天还有个做本地生活号的粉丝找我，说刚装的迅睿，改个列表标签就报错。点开后台一看，要么是少写了个符号，要么是参数值写错了格式。说白了，大部分人遇到的标签问题，根本不用翻厚厚的官方文档，就3种。

1.1 符号全角/半角搞混

这是入门级踩坑最多的，举个例子。你用list标签调新闻，输入

``` {module module=新闻 num=5 } ```

看起来没问题对吧？但你看逗号？哦不对刚才没有逗号，看空格和引号？或者直接看引号/冒号/等号这些关键符号。刚才的num=5如果不小心改成全角的“＝”，后台直接给你弹白屏或者红色报错。

避坑提醒：写标签时，输入法一定要切到英文半角，特别是复制粘贴后，要手动检查一遍。

1.2 参数名写错或者漏传必填项

迅睿的标签参数名，很多都是缩写或者有特定写法的。比如你要调“单篇文章详情”，不能自己瞎写module=文章详情，得是show模块，参数名必须是id或者catid+title，不能少写，也不能写反。

举个具体反例：

``` {show module=文章 id=} ```

这里id后面是空的，必填项漏了，肯定报错。再比如

``` {list module=新闻 page=1 pagesize=10 } ```

pagesize这个参数，在迅睿基础标签里根本不存在，正确的是limit或者配合page用pagesize？不对等下翻一下脑子里的干货——哦是page=1和limit=10同时用的话，才是分页每页10条。单独list标签没有必填项，但page参数不能单独写，必须加limit。

避坑提醒：不确定参数名的话，直接去后台标签管理里找对应标签的模板，直接复制粘贴修改就行，别自己造词。

1.3 参数值格式不对或者范围错

参数值分很多种，比如数字、字符串、布尔值（就是true/false，0/1），每种格式都不能错。

比如catid（栏目ID），必须是纯数字，不能加引号，不能写文字。如果你写

``` {list module=新闻 catid=美食 } ```

后台肯定找不到“美食”这个栏目ID，直接报错。还有limit参数，必须是数字组合，比如limit=5（前5条）、limit=2,5（第3到第7条），不能写limit=前五条。

再比如布尔值的return=0（不返回数据，只处理逻辑）和return=1（返回数据），不能写成return=是或者return=false（虽然有的时候false也能用，但建议统一用0/1，更稳妥）。

2. 秒查错误：2个免费工具帮你省1小时

哪怕你很小心，偶尔还是会写错。别慌，不用一行一行抠代码，用这2个工具，1分钟就能找到问题。

2.1 后台自带的标签调试模式

这个是迅睿官方给的最强工具，但很多新手根本不知道怎么开。说具体步骤：

• 第一步，登录迅睿后台，找到顶部的系统菜单；
• 第二步，点系统设置，再点左侧的开发调试；
• 第三步，找到模板标签调试，把开关改成开启，然后保存；
• 第四步，刷新前台报错的页面，就能看到红色的具体错误提示，比如“参数name不存在”“catid必须是数字”。

避坑提醒：调试完一定要把开关关掉，不然访客也能看到你的后台信息，不安全。

2.2 在线HTML/标签格式检查工具

如果调试模式开了还是没找到问题，可能是标签和HTML标签嵌套错了。比如你把list标签放在了p标签里面，HTML的p标签不能嵌套块级元素，这时候也会导致页面乱或者报错。

推荐用“站长工具HTML格式化”这个免费工具，把你的模板代码复制进去，点格式化，它会自动给你排版，还会标红嵌套错误的地方。

3. 5个高频标签的避坑修正模板

新手用得最多的就是这5个标签，我把正确的模板和常见错误修正放在一起，你直接对着改就行。

3.1 模块列表标签（list）

正确模板（调新闻前5条，按发布时间倒序）：

``` {list module=news catid=1,2 limit=5 order=updatetime desc}

{$t.title}{dr_date($t.updatetime,'Y-m-d')}

{/list} ```

常见错误修正：

• 错误1：catid=美食 → 改成catid=对应栏目的数字ID（后台栏目管理看）；
• 错误2：order=updatetime → 改成order=updatetime desc（倒序）或者order=updatetime asc（正序），不然顺序随机；
• 错误3：{$t.title}写成{$t.name} → 改成title，新闻模块标题的字段名是title。

3.2 单篇文章详情标签（show）

正确模板：

``` {show module=news id=$id} {$t.title}

发布时间：{dr_date($t.updatetime,'Y-m-d H:i')}

{/show} ```

常见错误修正：

• 错误1：id=空 → 改成id=$id（默认当前文章ID）或者id=具体数字ID；
• 错误2：content写成text → 改成content，新闻模块内容的字段名是content。

4. 最后给你2个永久避坑的小习惯

只要养成这2个小习惯，以后你写标签几乎不会出错。

4.1 复制官方模板修改

后台标签管理里，每个标签都有官方给的3-5个模板，都是正确的。你每次写新标签，先去复制一个最接近的，再慢慢改参数，别自己从零开始写。

4.2 写一段试一段

别一口气写几十行标签再去试，写个3-5行就刷新前台看一眼。如果出错了，范围小，很容易找到问题。

现在就去试试吧，先把后台的标签调试模式开一下，找到刚才报错的地方，对着我给的模板改，10分钟之内肯定能搞定。如果还有解决不了的，评论区留个言，我看到会回你。