第一步：检查后台栏目内容/属性配置
这是新手90%以上踩坑的点，先从后台最直观的地方开始。
1.1 检查栏目是否有已发布的内容
1. 登录EyouCMS后台，默认地址是`你的域名/admin.php`（若修改过后台入口，请用自定义的）
2. 左侧菜单栏找到
内容管理，点击展开找到对应报错的栏目
3. 查看该栏目下
发布状态是否有
已发布的文章/产品
4. 若没有，请先点击
添加内容，填写必要信息后勾选
已发布，最后点击底部
提交并保存
1.2 检查栏目属性是否匹配调用需求
EyouCMS的普通列表、二级列表、封面页属性完全不同，必须对应后台设置：
1. 左侧菜单栏找到
核心功能→
栏目管理
2. 找到报错的栏目，点击右侧的
编辑按钮
3. 查看
栏目属性字段：
- 若模板调用的是普通内容列表，属性必须选
列表页（终极栏目）
- 若模板调用的是二级栏目入口，属性必须选
封面页
- 若模板需要二级列表嵌套，上级选
封面页，下级选
终极栏目
4. 修改后务必点击底部
保存并生成栏目，刷新前台查看
第二步：检查模板文件的调用语法
EyouCMS的标签语法是ThinkPHP5简化版，哪怕漏一个字母、参数格式错误，都会导致不显示内容。
2.1 确认模板文件路径是否正确
EyouCMS前台默认模板存放在根目录的`/template/pc/`或`/template/mobile/`下，需先确认调用的是PC端还是移动端：
1. 左侧菜单栏找到
核心功能→
模板管理
2. 点击顶部的
PC端或
移动端标签
3. 点击展开当前使用的模板文件夹，找到该栏目对应的列表模板
- 终极栏目默认模板是`list_栏目ID.htm`，也可以在栏目编辑→
高级选项→
列表页模板自定义
- 封面页默认模板是`index_栏目ID.htm`
4. 点击模板右侧的
编辑按钮，进入代码编辑页
2.2 检查核心列表调用标签的完整性
必须用`{eyou:list}`标签调用列表，以下是
终极栏目可直接复制的完整标签，新手建议先替换后再微调：
```html
{eyou:list pagesize='10' titlelen='30' infolen='80'}
{$field.description}
{$field.addtime|MyDate='Y-m-d',}
{/eyou:list}
```
2.3 排查标签常见错误
替换后若还是不显示，逐一检查以下3个高频错误：
1.
标签闭合错误：必须有`{/eyou:list}`结尾，否则整个区块失效
2.
必填参数缺失：必须加`pagesize='数字'`，否则默认调用0条
3.
字段名拼写错误：EyouCMS的字段全是小写加下划线，比如`title`不能写成`Title`，`arcurl`不能写成`arcurl`
第三步：检查数据缓存与静态生成
EyouCMS默认开启缓存，哪怕修改了内容/模板，后台没清缓存前台也不会更新。
3.1 一键清除所有缓存
1. 登录EyouCMS后台，找到顶部的
缓存按钮（通常在右上角头像旁边）
2. 点击展开下拉菜单，勾选
数据缓存、
模板缓存、
碎片缓存（如果有的话）
3. 点击
清除缓存，等待提示“清除成功”
3.2 生成对应栏目静态页（如果开启了静态模式）
1. 左侧菜单栏找到
核心功能→
生成管理
2. 若只修复单个栏目，点击
生成栏目，勾选报错的栏目，点击
开始生成
3. 若全站都有问题，点击
一键更新，点击
开始生成
3.3 关闭静态模式临时测试
如果不确定是否是静态模式的问题，可以先关闭测试：
1. 左侧菜单栏找到
系统管理→
基本设置
2. 点击顶部的
核心设置标签
3. 找到
URL模式，选择
动态模式
4. 点击底部
保存，刷新前台查看，若显示正常再考虑修复静态生成路径
第四步：检查数据库表是否损坏
如果以上三步都没用，大概率是数据库的`ey_arctype`（栏目表）或`ey_archives`（内容表）损坏了。
4.1 登录phpMyAdmin
1. 打开你的服务器控制面板（比如宝塔面板、cPanel）
2. 找到
数据库模块，点击对应EyouCMS数据库的
phpMyAdmin
3. 输入数据库账号密码登录（账号密码在根目录的`/data/config/eyou_config.php`文件里可以找到，打开文件后搜索`db_username`和`db_password`）
4.2 修复损坏的表
1. 在phpMyAdmin左侧找到EyouCMS的数据库，点击进入
2. 找到`ey_arctype`和`ey_archives`两个表，勾选它们前面的复选框
3. 点击页面底部的
选中项下拉菜单，选择
修复表
4. 等待提示“修复成功”，返回EyouCMS后台，重复第三步的清缓存+生成静态操作
4.3 恢复备份数据（如果修复表没用）
如果修复表后还是不显示，说明数据丢失了，需要恢复最近的数据库备份：
1. 如果用宝塔面板，点击左侧
数据库→找到对应数据库→点击
备份→选择最近的一个备份→点击
恢复
2. 如果用EyouCMS自带的备份，左侧菜单栏找到
系统管理→
数据备份→点击
数据恢复→选择最近的一个备份→点击
开始恢复
3. 恢复后务必重复第三步的清缓存+生成静态操作
