上周三凌晨两点半，我被工作室做兼职的学妹哭哭啼啼吵醒。说上周老板给了套迅睿模板模板套公司官网，昨晚复制官网的“调用最新3条新闻”标签，直接首页跳500，今早9点半就要给甲方爸爸看验收报告。我远程登后台看了5秒，关掉了学妹加的一个多余空格——秒好。
其实不是迅睿CMS难用，也不是你笨，是很多教程只给标签不给“雷区细节”。今天就把10年做本地企业站踩过的、见过粉丝踩过的90%标签报错根源全说透，每一步都能直接抄作业，解决不出数据、乱码、页面空白这3个最头疼的问题。
1. 最容易犯的低级雷区：符号和空格问题
1.1 标点符号必须全是英文半角
很多小白写文档习惯用中文输入法，复制粘贴的时候顺手带了中文引号、中文逗号，标签瞬间失效。
举个学妹之前犯的错例子，她写的最新新闻标签是：
```
{module name=news catid=”10” num=3 order=updatetime desc}
```
看明白没？catid=后面是中文双引号“”，不是英文半角的""。
修复方法：
不管是改后台的模板编辑器，还是用Notepad++本地改模板，先把输入法切到英文半角模式。所有标签里的引号、逗号、等号、冒号、括号，全用这个状态下的。
如果已经写了一堆不确定的，可以全选模板代码，用Notepad++的“替换”功能，把中文双引号批量换成英文的，中文逗号也换一遍。
避坑提醒：有时候复制别人的教程标签，教程作者可能也没注意输入法，哪怕看起来符号一样，也得自己手动敲一遍。
1.2 标签首尾不要加多余空格/换行
很多人写代码喜欢对齐，比如在{module开头前面加几个空格，标签中间空一大截，标签结束后加好几行空行。
对齐本身没问题，但
标签内部的首尾和关键参数前后不要乱加。
比如之前帮一个洗车店老板改模板，他写的调用洗车套餐标签是：
```
{ module name=shop num=4 }
```
{后面多了2个空格，标签就识别错了，直接套餐列表全空。
修复方法：
用Notepad++本地改的话，可以打开“视图”→“显示符号”→“显示空格与制表符”，能看到所有看不见的空格/换行，把标签里没用的删掉就行。
对齐的话，只在标签外面空行或者加空格，标签开头{和结尾}紧贴着第一个/最后一个字符。
2. 中级雷区：参数设置和模型对应不上
2.1 模型名称一定要写对官方默认的
很多小白建站时，把后台“内容模型”里的“文章模型”改成了“公司新闻模型”，然后写标签时直接填了name=公司新闻模型，这肯定不出数据。
说白了，后台显示的模型中文名称是给你自己看的，标签调用要用
模型的英文标识。
举个官方默认模型的对应表：
- 中文单页：name=page
- 中文文章：name=news
- 中文图片：name=photo
- 中文下载：name=download
- 中文产品：name=product
如果自己新增了模型，比如“洗车套餐”，怎么找英文标识？
修复方法：
登录后台→内容→内容模型，找到对应的模型，第一列就是“模型标识”，比如新增的洗车套餐标识可能是xichetaocan，标签里就填name=xichetaocan。
2.2 栏目ID不能瞎填，要去后台看
这是踩坑率第二高的，仅次于符号问题。很多小白老板自己装的站，随便加了个栏目，以为栏目ID是1，结果后台早就默认创建了“首页”“联系我们”这些单页栏目，新闻栏目ID可能是3或者5。
还有的标签里写了catid，但参数值是栏目名称，比如catid=公司新闻，根本没用。
修复方法：
登录后台→内容→栏目管理，找到你要调用的栏目，鼠标移到栏目名称上，浏览器地址栏最后会显示catid=数字，这个数字就是正确的。
比如地址栏是http://你的域名/admin.php?c=category&a=edit&id=3，那栏目ID就是3。
避坑提醒：如果要调用多个栏目的内容，可以用英文逗号隔开，比如catid=3,5,7，但
逗号必须是半角的哦。
3. 高级雷区：模板标签的位置和权限
3.1 标签不能随便嵌套到另一个标签里
很多小白想在“最新新闻列表”里再嵌套一个“该新闻的所属分类”标签，本来是好事，但顺序或者嵌套规则错了，直接页面跳500。
比如之前有个装修公司的小白，写的标签是：
```
{module name=news num=3}
{title} - {module name=category catid=$t.catid}{name}{/module}
{/module}
```
分类标签嵌套得太随意了，迅睿不支持这么直接在内容标签里再套一个模块标签。
修复方法：
调用当前内容的所属分类，不用单独套模块标签，直接用迅睿内置的变量就行。
比如刚才的装修公司标签，改成：
```
{module name=news num=3}
{title} - {dr_cat_value($t.catid, 'name')}
{/module}
```
就完美了，{dr_cat_value(栏目ID, '要获取的字段')}这个内置变量，是专门用来快速调用分类信息的。
3.2 检查模板文件的权限，是不是读不了
这个问题一般出现在Linux服务器上，Windows本地测试很少见。
如果你所有符号、参数、位置都对了，还是页面空白或者提示“模板不存在”，那大概率是模板文件的权限不对，服务器读不了。
修复方法：
用宝塔面板的话，直接登录宝塔→文件，找到你的网站根目录→template文件夹→你用的模板文件夹，全选所有文件，右键→权限，改成755，勾选“应用到子目录”，确定就行。
不用宝塔的话，用FTP工具（比如FileZilla）登录服务器，找到对应的模板文件，右键属性，权限改成755，文件夹也是一样。
刚才说的这3个雷区，上周学妹踩了低级空格，上周装修公司小白踩了高级嵌套，昨天还有个水果店老板踩了中级模型标识。现在你把这篇文章收藏好，下次碰到标签报错，按顺序排查：先看符号空格，再看参数模型栏目ID，最后看位置权限。
现在就去打开你的迅睿后台，找个之前报错的模板，按照顺序查一遍，5分钟就能搞定。如果还有没解决的，评论区留你的报错截图和具体标签，我看到了会回复。
