现象
DedeCMS 5.7 改完模板刷新前台,页面把 {dede:arCLIst} 这类标签连大括号一起原样输出了,浏览器里能看到完整的标签代码,列表位置一片空白。换成系统自带的默认模板又正常,说明程序本身没坏。
原因
模板文件必须放在 templets 目录下且后缀为 htm,放到别的目录或者用 php 后缀,解析器根本不会处理;data/tplcache 里缓存了编译结果,只改模板不清缓存,前台还是旧内容;标签嵌套层级写错或者没有闭合,解析器遇到不认识的标签会跳过整段;后台把模板引擎相关的开关关掉,标签也会原样输出。
解决步骤
第一步,确认路径与后缀。核对模板是否在 templets/模板名/ 目录下,文件名后缀必须是 htm,然后用 grep 确认标签确实写进了这个文件,而不是改到了备份目录。
ls -l /www/wwwroot/dede/templets/default/index.htm
grep -n "arclist" /www/wwwroot/dede/templets/default/index.htm
rm -rf /www/wwwroot/dede/data/tplcache/*
第二步,检查标签闭合与参数引号。每个 {dede:xxx} 都要有对应的 {/dede:xxx},属性值用双引号包住,标签内部不要再嵌套同名的开始标签,否则解析会提前截断。
第三步,清缓存并重新生成。删除 tplcache 下的编译文件,回后台更新系统缓存,再生成一次首页与栏目页,让新模板重新编译。
验证
前台列表位置正常输出文章标题与链接,查看源码里不再出现 {dede: 字样,后台生成日志没有模板语法错误。
小结
标签原样输出不是标签写错,而是模板没被解析。先确认目录后缀,再清编译缓存,最后检查闭合,三步就能定位。
