dedecms模板制作常见错误解析，帮你快速解决问题！

发布日期： 2025-11-27 阅读量： 作者： admin

今天得空，正好把我前段时间捣鼓 Dedecms 模板那事儿，给大家说道说道。纯粹是自己瞎折腾的记录哈，说不上啥专业教程，就是个过程分享。

准备工作

我手上就一套静态的 HTML 页面，就是那种用 Dreamweaver 或者啥工具直接能打开看的网页，有首页、列表页、内容页这些。我寻思着，得先把这套皮给套到 Dedecms 上去。

所以第一步，肯定是在我自个儿电脑上把 Dedecms 给装好。这个过程就不细说，反正就是按着官方的步骤来，弄个本地环境跑起来。

扒拉模板结构

装好之后，我就去看 Dedecms 自带的那个默认模板，在 `/templets/default` 目录下。我就琢磨着，我得把我那套 HTML 文件，改成 Dedecms 能认得的结构。

大概看下，就明白：

公共的头部，就放 `*` 里。
公共的脚部，就放 `*` 里。
首页嘛自然是 `*`。
文章列表页，一般叫 `list_*` (当然也可以根据栏目 ID 或者类型叫别的)。
文章内容页，就是 `article_*`。

知道这个，我就把我那套静态 HTML 文件，咔咔咔地拆开，该放 `*` 的放进去，该放 `*` 的放进去，然后把首页内容弄到 `*`，列表页弄到 `list_*`，内容页弄到 `article_*`。先把架子搭起来。

套标签，体力活

这步是关键，也是最费事的。就是要把原来静态页面写死的内容，换成 Dedecms 的标签，让它能动态地去数据库里抓数据。

先把公共部分搞定：

在 `*`、`list_*`、`article_*` 这些文件的开头和结尾，把我之前拆出来的头部和脚部内容，用 `{dede:include filename="*"/}` 和 `{dede:include filename="*"/}` 给包含进来。这样改起来方便，改一个地方，所有页面都生效。

然后是首页 `*`：

导航栏，我用的 `{dede:channel type='top'}` 这个标签，循环输出顶级栏目。新闻列表、产品展示这些，就用 `{dede:arclist}` 标签，指定一下要调用的栏目 ID (`typeid`)，显示多少条 (`row`)，标题多长 (`titlelen`) 等等。图片轮播的地方，我也是用 `arclist` 配合 `flag='h'` (幻灯片) 来调用的。这块就是不停地试标签参数，看效果。

接着是列表页 `list_*`：

列表页主要是文章列表，我用的是 `{dede:list}` 标签，它会自动根据当前栏目来显示文章。然后是分页，这个得用 `{dede:pagelist}` 标签。我记得搞这个分页的时候，出点问题，有时候页码显示不对，或者链接有问题。我当时查半天，调调后台的“核心设置”里的那个“DedeCMS安装目录”，把它清空，然后更新缓存，好像就好。也有时候是模板里分页标签的样式名 (`listsize`, `listitem`) 没写对。反正这里折腾一小会儿。

是内容页 `article_*`：

这个相对简单点，主要就是显示文章的具体内容。

文章标题：`{dede:*/}`
发布时间、作者、来源这些：`{dede:* function='strftime(...)'/}`、`{dede:*/}`、`{dede:*/}`
文章正文：`{dede:*/}`
当前位置（面包屑导航）：`{dede:field name='position'/}`

对，还遇到个小插曲，就是后台发布的文章标题如果设置加粗，前台显示的时候，那个 `{dede:*/}` 会自动带上 `` 或者 `` 标签，有时候会影响样式。我后来是直接用 CSS 来控制标题样式，不管它带不带标签。

整理 CSS 和 JS

把原来静态页面用的 CSS 文件、JS 文件还有图片啥的，我都放到 Dedecms 模板目录下新建的一个文件夹里，比如 `/templets/mytpl/style`、`/templets/mytpl/js`、`/templets/mytpl/images`。然后在 `*` 里，把原来引用这些文件的路径，改成 Dedecms 能识别的模板路径，类似 `{dede:*_templets_skin/}/style/*` 这样。

上传、测试、改改改

模板文件在本地改得差不多，我就把整个模板文件夹（比如叫 `mytpl`）传到服务器上 Dedecms 安装目录下的 `/templets/` 文件夹里。

然后在 Dedecms 后台，“系统” -> “系统基本参数” -> “模板设置”，把“默认模板风格”选成我刚上传的那个 `mytpl`。

接下来就是关键一步：“生成” -> “一键更新网站”，把所有页面都重新生成一遍。

这时候，十有八九会遇到些问题：

页面样式乱：多半是 CSS 或 JS 路径没改对，或者 CSS 有冲突。

数据显示不出来：检查标签是不是写错，比如字母大小写、参数名啥的。有时候也可能是标签被禁用，比如想用 `{dede:php}` 但系统默认是关的，后台“系统设置”里能看到禁用的标签。

图片不显示：路径问题，检查模板里的图片路径。

分页点不或出错：又回到分页问题，检查标签、检查后台设置、更新缓存。

提示“模板文件不存在”：这个我也碰到过，有时候是栏目或者文章的模板设置错，比如某个栏目指定要用 `list_*`，但你模板文件夹里没这个文件。还有的时候是服务器文件权限问题，确保模板文件夹权限是 755，里面的文件权限是 644，这个得用 FTP 工具或者服务器管理面板调。

基本上就是这样一个“修改模板 -> 上传 -> 后台更新 -> 查看效果 -> 发现问题 -> 回去修改”的循环过程。得有点耐心，慢慢调。

收尾

等主要的页面显示都正常，数据也能正确调用，就开始对细节进行打磨。调整一下 CSS 让页面更好看，检查各个链接是不是都有效，不同浏览器下看看有没有兼容问题等等。

Dedecms 做模板不算特别复杂，主要是熟悉它的标签和文件结构。过程有点繁琐，尤其是刚开始的时候，各种标签、参数、路径容易搞混。但多捣鼓几次，把一套模板完整做下来，基本也就熟练。这回实践就先记录到这，希望能给同样在折腾的朋友一点点参考。

上一篇

南充招聘网最新招聘信息怎么看？教你快速筛选合适岗位！

下一篇

暂无

随便看看

如何优化公司网站，怎样才能提高转化率 发布日期： 2025-10-27

网站推广费用太高？教你几招省钱小技巧！ 发布日期： 2025-11-06

行业品牌推广案例分享？成功经验直接大放送！ 发布日期： 2025-11-06

太原市网站建设，如何才能找到性价比高的公司 发布日期： 2025-10-26

网站优化企业，你了解SEO优化吗 发布日期： 2025-11-01