海洋 CMS 模板标签调用语法怎么学习

海洋CMS 的模板标签没有一本官方出版的手册式教材，最快的学法就三步：**拿官方默认模板当字典、用「一个页面只放一个标签」的最小测试法验证、再把验证结果整理成自己的速查表**。按这个顺序走，通常 2-3 天就能从「抄模板」过渡到「自己写模板」。

海洋CMS 的模板标签长什么样？

结论：海洋CMS 的模板文件本身就是 HTML，标签只是嵌在 HTML 里的解析标记，分「成对标签」和「单标签」两类。

打开后台模板管理里自带的那套默认模板（通常叫 default，里面有 index.html、list.html、content.html、play.html 等文件），你能看到两种形态：

• 成对标签：形如 {seacms:videolist ...}...{/seacms:videolist}，中间夹循环体，列表类标签基本都是这一种；
• 单标签：形如 {seacms:sitename} 这种直接输出一个值的，常见于站点名、站点地址、关键词等全局信息。

循环体内部的字段通常写成方括号形式，比如：

{seacms:videolist num=10}
  <li><a href="[videolist:link]">[videolist:name]</a></li>
{/seacms:videolist}

上面这段是示意结构，具体字段名（是 name 还是 vodname、参数是 num 还是 limit）各版本分支并不统一，所以第一件事是确认自己的海洋CMS 版本号（后台首页能看到），再去对应该版本的官方模板说明和默认模板文件，不要拿别的版本教程硬套。

学海洋CMS 模板标签的正确顺序是什么？

结论：按「抄 → 拆 → 测 → 记」四步走，比通读文档快得多。

1. 抄：先把默认模板原样复制一份改名（例如 default2），前台切换到这套模板，确认能正常显示。这一步保证你后面改坏了随时能切回默认模板。
2. 拆：从 index.html 开始，一次只删掉 1 个标签，刷新前台看哪个区域消失，就知道这个标签负责哪块内容。用浏览器「查看网页源代码」对比，标签被成功解析时前台源码里不会出现 {seacms: 字样；如果源码里还带着花括号，说明这个标签没被识别或参数写错了。
3. 测：新建一个只放 1 个标签的测试模板，参数每次只改 1 个值（先把数量从 10 改成 5），刷新看结果变化，这样能反推出参数作用，比看文档印象深。
4. 记：把验证过的标签连同参数写进自己的速查文件，格式建议「标签名 + 参数 + 用途 + 验证日期」，下次直接查。

模板改了不生效怎么办？

结论：九成以上是缓存或改错了文件，按下面 3 步排查。

第一，海洋CMS 会缓存模板解析结果，改完模板要先在后台清缓存（模板编译缓存目录一般也是缓存清理的对象），再去前台刷新，必要时用 Ctrl+F5 强制刷新浏览器。第二，确认你改的文件和前台当前启用的模板是同一套——很多站点同时存在 2-3 套模板目录，改错目录是最高频的失误。第三，检查文件编码，模板文件保存为 UTF-8 且不带 BOM，带 BOM 会导致页面顶部出现空白行甚至标签解析异常。

有哪些必须记住的坑？

结论：三个硬规则——标签必须成对闭合、参数值含空格要加引号、改模板前先备份。

成对标签漏掉 {/xxx} 结尾，页面会从该处开始整段错乱；参数写了中文空格或全角引号，标签会解析失败并原样输出；至于备份，最省事的做法就是前面说的「复制一套模板再改」，成本是 1 次点击，收益是你永远有退路。

总结

学海洋CMS 模板标签的关键不是背语法，而是先锁定自己的版本号，把默认模板当字典，用「单标签最小测试 + 查看前台源码」这两招验证每个标签和参数，再把结论沉淀成个人速查表。遇到改完不生效，先查缓存、再查模板目录是否用错、最后查 UTF-8 无 BOM 编码，这三步能解决绝大多数问题。