海洋 CMS 模板修改后前台不生效怎么办

海洋 CMS 模板修改后前台不生效，90% 的原因只有两个：改的不是前台正在加载的那个模板文件，或者模板编译缓存／静态页缓存没清。按下面顺序排查，通常 5 分钟内能定位。

为什么改了模板前台没变化？先清三层缓存

结论：海洋 CMS 的模板不是直接输出的，改完 .htm 模板文件后必须清缓存，前台才会重新解析。

第一层是系统缓存。海洋 CMS 会把模板标签解析成 PHP 中间文件，缓存在 data 目录下的缓存文件夹里。只改模板不清缓存，前台读到的仍是上一次编译结果。做法是进后台点「更新缓存／清除缓存」，或直接删除服务器上 data 目录里的缓存子目录内容（保留目录本身和权限）。

第二层是静态页缓存。如果站点开了静态生成，前台访问的 xxx.html 是生成好的死文件，模板改了它也不会变。这时要在后台重新生成对应栏目／文章页，或者删掉旧的 .html 再生成一次。

第三层是浏览器和 CDN。先按 Ctrl+F5 强制刷新，或换无痕窗口；用了 CDN 或 Nginx 反代的话，去 CDN 控制台刷新那个 URL 的缓存。三层里只要有一层没清，就会表现为「怎么改都不变」。

怎么确认你改的模板就是前台正在加载的那个？

结论：用「加注释标记法」一秒钟验证，比对着后台设置猜快得多。

在模板文件最顶部加一行明显的 HTML 注释，例如 <!-- test-2024 -->，保存后刷新前台，右键查看网页源代码，搜这个字符串：

• 搜得到 → 文件对了，问题在缓存或标签语法；
• 搜不到 → 你改的根本不是当前生效的模板。

搜不到时重点查两件事：一是后台「当前模板」选的是哪一套，海洋 CMS 支持多套模板共存于 templates 目录，改错目录是高频失误；二是 PC 模板和手机／移动端模板是分开的两套文件，用手机访问测的却改了 PC 模板，自然不生效。

模板标签写错了会怎么样？

结论：标签语法错误会让整段甚至整页解析失败，前台看到的可能是空白或原样输出的标签文本。

海洋 CMS 模板标签需要成对闭合，常见的 {if}...{/if}、{loop}...{/loop} 少了闭合标签，解析器就会跳过后续内容。改完模板后如果页面某块突然空白，先回退到修改前，再一小段一小段地改、每改一次刷新一次，用二分法定位出错的那一行。

另外注意文件编码：模板必须保存为 UTF-8 无 BOM 格式。用记事本另存时带了 BOM 头，会在页面顶部多出空白或乱码，严重时导致页面头部输出异常，看起来就像「模板没生效」。

权限和文件属主需要怎么设置？

结论：模板文件权限设 644、目录设 755，属主与 Web 运行用户一致，否则后台保存／系统清缓存可能写不进去。

Linux 下常用命令：文件 chmod 644 xxx.htm，目录 chmod 755 templates，属主 chown -R www:www templates data（www 换成你服务器实际的运行用户，如 nginx、apache、www-data）。如果缓存目录不可写，系统会一直用旧缓存或每次重新编译，表现就是「改了时好时坏」。

排查顺序清单

按这个顺序走，不要跳步：一、强制刷新 + 换无痕窗口；二、后台清除缓存；三、加注释标记法确认文件是否是当前模板；四、确认改的是 PC 还是手机模板；五、确认是否开了静态生成并重新生成；六、检查标签闭合与 UTF-8 无 BOM 编码；七、检查 templates 与 data 目录权限属主。绝大多数「模板不生效」在前三步就能解决，剩下的多半是标签语法或权限问题。