用帝国CMS做站八年，前前后后改了不下上百个列表模板，说实话，这玩意儿看着简单——不就是循环输出标题和缩略图嘛，可真上手了，坑一个接一个，今天不整虚的，把我踩过的雷、试出来的方案全撂这儿,你能少走弯路就少走。
帝国CMS列表模板别瞎折腾，这五个坑我替你踩过了，照着改能省三天时间
坑一：列表页SQL直接写死，换栏目就白屏
最早我给一个行业门户做分类列表，图省事，在列表模板里用 select * from phome_ecms_news 这种写死的表名，当时跑得好好的，后来客户加了个“视频”模型，栏目列表直接报错，因为不同模型的表名不一样，你写死了新闻表,视频模型的数据根本查不出来。
解决方案： 用帝国CMS自带的标签，别自己拼SQL，列表页用 [ecmsinfo] 或者列表模板里的 list.var 循环，帝国会自动根据当前栏目的模型匹配数据表，如果非要自定义查询，用 $GLOBALS['navclassid'] 动态判断，别把表名写进字符串里，我现在的习惯是：列表模板只写 [!--title--] 这种标准字段，复杂需求用“列表模板自定义查询”功能，但条件里一定带上 classid 和 tbname 变量。
坑二：分页链接收录成乱码，流量白白丢
有次给客户做资讯站，列表页用伪静态，分页是 index.html、index_2.html 这种格式，上线一个月，百度收录全是首页和第一页，后面的分页一个没抓，查了半天，才发现是列表模板里分页函数写错了——我用了 [!--show.page--]，但没设置“列表分页字段”的伪静态规则，导致生成出来的分页链接是 ?page=2 这种动态参数，帝国CMS默认动态分页也能用，但搜索引擎对动态参数的抓取积极性低很多,尤其新站。
解决方案： 去“系统设置-伪静态参数”里，把列表分页的规则配好，list_1.html、list_2.html，模板里别用默认的 [!--show.page--]，用 [!--list.pagenav--] 加上自定义样式，保证输出的是带 list_ 前缀的静态链接，列表模板里一定要加 <link rel="next" href="..."> 和 <link rel="prev">，老手都知道,这比内链权重传递实在多了。
坑三：缩略图不裁剪，手机端加载卡成狗
帝国CMS的缩略图功能默认是“按原图缩小”，不裁剪，你传一张800x600的图，列表里显示200x150，它还是把整张800的图下载下来再缩小，移动端流量哗哗地烧，用户早跑了，我第一次做商城列表，产品图一百多个，每个原图2MB，列表页加载了十几秒,被客户骂惨了。
解决方案： 用帝国自带“缩略图裁剪”插件，或者后台“系统设置-图片设置”里开启“生成缩略图时裁剪”，推荐用 [!--titlepic--] 配合“缩略图宽度/高度”字段，让后台自动生成固定尺寸的裁剪图，一定开启“图片懒加载”，帝国CMS有现成插件，搜“帝国CMS懒加载”就有一个免费的在用，列表页的缩略图我会再加上 loading="lazy" 属性,兼容性没问题。
坑四：缓存没开，一刷新CPU就飙红
很多新手不知道帝国CMS列表页是动态查询数据库的，就算生成静态HTML，后台一更新文章，列表页要重新生成，如果文章多、栏目多，生成过程会瞬间拉高CPU，我当年做过一个十万文章的行业站，每次更新列表,服务器直接死机。
解决方案： 第一，开启“列表页缓存”，在“系统设置-性能优化”里把“列表页缓存时间”设成300秒，这样就算动态访问，也读的是缓存，不会每次都查库，第二，用“按栏目生成HTML”功能，别全站一起生成，可以选择“只生成有更新的栏目”，第三，推荐装一个“帝国CMS定时生成插件”，我目前在用的是“帝国定时任务小助手”，设定每5分钟只生成最新发表文章所在栏目,避开高峰期。
坑五：列表模板里写业务逻辑，改需求得改半天
早期做地方分类信息站，我把“是否推荐”“是否置顶”这些判断全写在列表模板里，用了大量 if 和SQL，后来客户要调整排序规则，置顶的按时间倒序，非置顶的按浏览量倒序”，我改模板改了两小时,还差点把栏目搞挂。
解决方案： 所有复杂的查询和判断，都用“自定义列表函数”或者“系统内置标签”实现，模板里只保留输出标签，帝国CMS有个“列表模板-标签调用”的规范：数据筛选逻辑统一写在“数据调用”里，模板只负责循环输出，推荐用 [ecmsinfo] 标签的“栏目ID=当前栏目，显示条数=10，操作类型=推荐，排序=时间”这种参数组合，完全能满足90%的需求，剩下的10%，写在自定义PHP文件里，然后返回 $list 数组，模板里 foreach 就行,维护起来一目了然。
长期维护建议
- 列表模板一定要留备份，放在
/e/template/list/下，命名带日期，list_news_202506_01.php，改之前复制一份,改错了能秒回滚。 - 后台“数据更新”里的“更新列表页”每天凌晨跑一次，设置成计划任务，白天更新文章，晚上统一生成列表,避免高峰期卡顿。
- 列表模板里别用
phpinfo()、eval()，别问为什么,被黑过的人都知道。 - 定期检查列表页生成的HTML大小，如果一个列表HTML超过500KB，说明你一次输出的内容太多了，分页条数调小（建议20条）,或者压缩摘要长度。
- 用“帝国CMS后台-栏目管理-批量更新栏目”的时候，记得先关掉列表页缓存，生成完再打开，不然你改了模板,刷新页面还是旧样子。
最后一句掏心窝子的：帝国CMS列表模板最重要的不是花哨，而是稳定和好维护，你按上面这套来，哪怕以后换人接手，也能一眼看懂，别问我是谁,一个在帝国CMS坑里爬起来的老站长相。
发表评论