海洋 CMS 分类添加之后前台不显示怎么办

海洋CMS 分类添加后前台不显示，按出现频率排只有四类原因：分类被设成了隐藏、后台缓存没清、静态页面没重新生成、分类绑定的模板文件不存在。按这个顺序排查，十分钟内基本能定位到具体是哪一环。

分类添加后前台不显示，第一步该查什么？

结论：先查分类的显示状态和上级分类设置，这两项错了，后面做什么都没用。

海洋CMS 后台的分类管理里，每个分类都有状态字段（不同版本叫「是否显示」「隐藏」「状态」）。建分类时如果勾了隐藏，这条记录只进数据库，不会出现在前台导航、列表页和搜索结果里。第二个高频错误是「上级分类」选错：选成了一个隐藏分类或已删除的分类 ID，子分类不会自动升到一级，前台照样看不见。

修法很直接：编辑该分类，上级分类选「顶级分类/无」，状态改成显示，保存。

后台能看到分类，前台看不到，是缓存问题吗？

结论：是。海洋CMS 会把分类树、导航结构缓存成文件，改完分类不清缓存，前台读到的还是旧数据。

操作步骤：进后台「系统」→「清除缓存」（部分版本放在「工具」或「系统设置」菜单下）；如果没找到菜单项，直接删服务器上缓存目录里的文件，路径为 /data/cache/，部分版本是 runtime/cache/。清完刷新前台页面。

如果站点挂了 CDN 或 Nginx 做了页面缓存，还要在 CDN 控制台刷新一次目录或 URL，否则你清的是源站缓存，用户拿到的还是边缘节点上的旧 HTML。

海洋CMS 新增分类后必须重新生成页面吗？

结论：必须。海洋CMS 前台默认输出静态 HTML，新增分类只写了数据库，首页和栏目页的 HTML 不会自动更新。

做法：后台「生成」→ 先「生成首页」，再「生成栏目页」（或用「一键生成全部」）。只生成首页不够——导航链接指向的是栏目页 HTML，栏目页没重新生成，点进去就是 404 或者旧的缓存页面。

这里有个容易踩的点：生成目录（常见为 /html/ 或站点根目录）必须有写入权限，Linux 下至少 755。权限不足时生成过程会静默失败，后台看着没问题，前台就是不更新。

分类绑定的模板错了会怎样？

结论：分类必须绑定实际存在的模板文件，模板缺失时栏目页生成失败，前台表现为空白页或 404。

分类编辑页里有「列表页模板」「内容页模板」两个字段。字段留空时走系统默认模板，通常是能正常显示的；一旦填了模板名，而 /templates/你的模板目录/ 下没有同名文件，生成时就会报错。

排查方法：把这两个字段暂时清空，重新生成，能显示就说明是模板文件名写错了，再对照模板目录里的实际文件名填回去。

完整排查清单：五步走完

1. 分类状态改「显示」，上级分类设为顶级；
2. 后台清缓存 + 删除 /data/cache/ 下文件；
3. 确认模板字段为空或用存在的模板名；
4. 重新生成首页和栏目页；
5. 检查生成目录权限，看后台有无生成失败提示。

五步走完还不显示，再检查前台模板里的导航调用标签——有些模板把一级导航写死在 HTML 里，新分类不会自动出现，需要手动在模板的导航区域加一条链接。另外确认分类排序值没有和其他分类完全冲突，排序重复只会导致顺序异常，不会让分类消失。

总结一下：海洋CMS 分类不显示，本质是「状态没开、缓存没清、静态页没生成、模板没对上」这四件事之一或叠加。改分类 → 清缓存 → 重新生成，是每次新增分类后必须走完的三步，顺序不能省。