LECMS标签调用语法是什么 精华

学完这篇你能照着在 LECMS 模板里写出能跑通的标签调用，把文章列表、详情字段、栏目导航和分页正确渲染出来，并在写错时知道去哪儿查、怎么排查。

第一步：先认清 LECMS 标签的整体结构

LECMS 的模板标签是「成对出现」的，一个开标签带若干参数，中间是循环体，最后用闭标签收尾。看懂这个骨架，剩下的都是换名字和换参数。

{lecms:article catid="1" num="10" order="id desc"}
    <li><a href="{$v.url}">{$v.title}</a></li>
{/lecms:article}

拆开看四部分：

• lecms —— 标签前缀，LECMS 的模板引擎所有内置标签都用它开头；
• article —— 标签名，决定你要取什么数据（文章、栏目、评论……）；
• catid="1" num="10" —— 参数，写法固定是 参数名="值"，多个参数之间用空格隔开，不要用逗号；
• {$v.title} —— 循环体内的变量，$v 代表「当前这一条」，点号后面跟字段名。如果点号写法在你的版本里不生效，改成 {$v['title']} 试试，两种写法在多数版本里都能用。

第二步：查清你当前版本到底有哪几个标签名

这一步的目标是拿到一份「你这个站点真能用」的标签清单，避免照抄网上旧教程发现标签名对不上。

两个可靠入口：

1. 后台查——登录后台后，进「模板」菜单（有的版本在「系统」→「模板管理」下），找「模板标签」「标签说明」或「标签向导」这一类页面，里面会列出可用标签和参数；
2. 直接翻默认模板——站点根目录下的 template/ 里是各套模板文件夹，打开里面任意 .html 文件，能看到官方自己是怎么写标签的，这是最不会骗人的参考。

注意：LECMS 不同版本的标签名有过调整，同一个功能可能叫 list 也可能叫 article。不要因为某个标签在别人博客上能用就直接复制，先在你自己的模板文件里找到同类标签确认。

第三步：按页面类型选对取数标签

不同页面取的数据不一样，用错标签会出现「列表页取不到内容」这类问题。

• 列表页（栏目页、首页）：用带 catid 的循环标签，catid 填栏目 ID，num 填条数；
• 详情页（文章内页）：不需要循环标签，直接输出当前内容的字段，通常是 {$info.title}、{$info.content} 这类写法，具体变量名以模板文件里已有的为准；
• 导航栏：用栏目导航类标签，一般支持 pid（父级 ID）指定从哪一级开始取。

第四步：把常用参数用熟

参数决定「取哪些、取几条、怎么排」，几个高频的记住就够日常用：

• catid="3" —— 指定栏目，多个栏目可用英文逗号分隔（如 catid="3,5,7"）；
• num="10" —— 取几条，有的版本写 limit="10"，以实际文档为准；
• order="id desc" —— 排序，desc 从新到旧，asc 反之；
• where="..." —— 附加筛选条件，写复杂条件前建议先在测试模板里验证；
• cache="3600" —— 缓存秒数，首页这种访问量大的页面加上能明显减轻数据库压力。

注意：参数值一律用半角双引号包起来，写成中文引号或漏掉引号，标签会直接不解析、原样输出到页面上。

第五步：调不通时的排查顺序

按这个顺序查，八成问题能自己解决：

1. 标签原样显示在页面上 → 模板缓存没更新，进后台点「清除缓存」或删除 runtime/ 下的编译缓存目录；
2. 标签消失但没内容 → 参数名写错或该栏目下确实没数据，先把 num 调大、去掉 catid 试一次；
3. 变量输出空白 → 字段名不对，去数据库对应的表里核对真实字段名；
4. 页面报错 → 打开调试模式看具体报错行，比盯着模板猜快得多。

小结

• 标签结构固定：{lecms:标签名 参数="值"}循环体{/lecms:标签名}，参数用空格分隔、值用半角双引号。
• 循环体内用 {$v.字段名} 取当前条数据，详情页用 {$info.字段名} 这类直接变量。
• 标签名和参数以你后台的标签说明页或 template/ 下官方模板为准，别照抄旧教程。
• 高频参数是 catid、num/limit、order、where、cache。
• 标签不解析先清缓存，输出空白先核对字段名。