织梦网模板怎么更换？目录结构与调用方法详解

更换织梦（DedeCMS）模板，不只是把一套 HTML 文件复制到服务器。模板文件放在哪里、站点默认使用哪个模板目录、栏目绑定了哪一个列表页和内容页模板，以及生成页面时是否重新解析模板，都会影响最终结果。只替换首页文件，通常不会让栏目页和文章页一起变化；只修改模板文件，也不一定会立即看到效果。

本文以常见的 DedeCMS 5.7 系列部署方式为例，讲解模板目录、模板选择、常用标签、页面生成和排错方法。不同版本、二次开发程序及安装包可能调整了后台菜单、标签行为和配置项。遇到差异时，应以当前站点后台设置和实际模板文件为准，不要把本文中的示例参数当作所有版本的固定限制。

一、先弄清模板在织梦中的作用

DedeCMS 的模板通常是带有织梦标签的 HTML 文件。生成页面时，系统会读取模板，把栏目、文章、网站配置等数据交给标签处理，最终输出 HTML。模板主要负责页面结构和展示，不等同于栏目数据、文章内容或站点程序本身。

例如，模板中的 {dede:field.title/} 用于输出当前页面可用的标题字段；{dede:arclist} 可以查询并循环输出文章列表。标签的可用字段、属性和解析时机，取决于所在页面类型和系统版本。模板文件即便扩展名是 .htm，其中的织梦标签也不是浏览器原生语法，必须经过 DedeCMS 解析后才会成为普通 HTML。

适合更换模板的场景

• 调整首页、栏目页和内容页的整体布局与视觉风格。
• 把已经制作好的 HTML 页面改造成能够读取织梦栏目和文章数据的模板。
• 修正导航、列表、分页、面包屑等页面组件的展示方式。
• 为不同栏目或内容模型绑定不同的列表模板、文章模板。

模板更换不能代替的工作

• 更换模板不会自动创建栏目、文章、频道模型或数据库字段。
• 模板不能替代程序升级、漏洞修复、服务器配置或数据迁移。
• 如果原网站使用了定制标签、插件或二次开发逻辑，新模板未必能直接兼容。
• 模板文件改动后，已经生成的静态页面通常需要重新生成，才能体现改动。

二、常见模板目录与文件

在常见安装中，模板目录位于站点根目录下的 templets，默认风格目录常见为 templets/default。目录名可以不同，网站使用哪个目录，应查看系统配置和后台设置，不能仅凭文件夹名称判断。

网站根目录/
├── dede/                    后台目录，实际名称可能已修改
├── include/                 系统程序文件
├── templets/
│   ├── default/             常见默认模板目录
│   │   ├── index.htm        首页模板
│   │   ├── head.htm         头部公共模板
│   │   ├── footer.htm       底部公共模板
│   │   ├── list_article.htm 列表页模板示例
│   │   └── article_article.htm 内容页模板示例
│   └── mytheme/             自定义模板目录示例
├── uploads/                 常见上传目录
└── ...

文件名只是约定示例。一个模板包可能叫 index.htm、list_news.htm 或其他名称；栏目实际使用的文件由后台栏目设置决定。列表模板通常用于栏目列表页，内容模板通常用于文章详情页，但不同安装包、内容模型和二次开发项目可能采用不同命名，不能只靠文件名推断页面绑定关系。

常见的公共模板还包括搜索、标签、专题、单页等模板。是否存在这些文件、文件叫什么，取决于站点启用的功能和模板包。接收模板包后，先检查其目录结构、文件引用和标签，再对照后台设置，不要把整个压缩包不加检查地覆盖到正在运行的模板目录。

三、更换前的准备工作

1. 备份文件与数据库。至少备份当前使用的模板目录、站点配置和数据库。只备份模板不能恢复栏目绑定、系统设置或内容数据。
2. 确认当前模板目录。查看后台系统基本参数中的默认模板风格等设置，并核对服务器上的实际目录。不同版本字段显示名称可能略有差异。
3. 记录栏目模板设置。在栏目管理中检查栏目使用的列表页模板、内容页模板和相关封面模板。很多站点的栏目各自指定了模板。
4. 确认模板包完整性。检查是否包含首页、公共头尾、列表页、内容页及所需静态资源；确认图片、CSS、JavaScript 的相对路径是否正确。
5. 在测试环境先验证。尤其是旧站、定制站或含有插件的站点，不建议直接在生产环境覆盖文件。模板标签解析错误可能导致页面空白、列表缺失或生成失败。

四、部署模板并设置默认风格

假设模板包解压后得到 mytheme 文件夹，先把目录上传到站点的 templets 下，形成 templets/mytheme/。不要误传成 templets/mytheme/mytheme/，也不要只上传压缩包中的图片和样式表而漏掉模板文件。

随后进入织梦后台，找到系统基本参数相关设置，将默认模板风格调整为模板目录名称。常见配置项名称是 cfg_df_style，但后台界面、配置存储位置及具体显示方式可能因版本或改版而不同。通常填写的是风格目录名，例如 mytheme，而不是完整文件系统路径。保存后应检查系统读取到的模板目录是否对应 templets/mytheme。

如果后台设置无法保存，或保存后仍然读取旧目录，不要立即手改多个配置文件。先核对目录是否存在、服务器进程是否有读取权限、后台是否成功保存，以及站点是否有二次开发的模板路径配置。手动改配置前应备份文件，并确认该站点的实际配置机制。

五、首页、栏目页和内容页分别怎么换

1. 更换首页模板

常见首页模板文件名为 index.htm。将新首页模板放入当前使用的风格目录，并确认首页生成流程使用的是该目录下的文件。织梦站点通常需要在后台执行首页更新或生成操作；具体菜单名称会随版本而异。仅通过浏览器访问首页，未必会触发模板重新解析，因为生产站点可能直接提供已经生成的静态文件。

首页通常包含头部、导航、内容区和底部。若模板通过 include 引入公共模板，必须保证被引用文件位于系统能够找到的位置，且文件名大小写与服务器文件系统相符。

2. 更换栏目列表模板

在栏目管理中编辑目标栏目，找到列表模板相关设置，选择或填写新模板文件名。常见做法是将模板放在当前风格目录中，然后填写相对于模板目录的文件名；但有些版本或定制界面的字段说明会不同，应按后台提示填写。

每个栏目可以单独指定列表模板。因此，修改默认模板文件后，有些栏目仍可能使用旧模板。需要逐个检查栏目配置，特别是父栏目、子栏目、封面栏目和使用独立模板的栏目。

3. 更换文章内容模板

内容页模板通常由栏目配置和内容模型共同影响。编辑栏目时检查文章模板设置；如果站点有多个内容模型，还要确认当前文档所属模型与模板字段相匹配。更换内容模板后，已有文章的静态页面也需要重新生成，才会使用新的模板输出。

4. 单页、专题和其他页面

单页、专题、搜索页等功能可能有各自的模板配置和生成入口。更换首页或文章模板不代表这些页面会同步更换。修改前先确认页面类型、生成方式及对应模板设置；如果是插件或二次开发页面，还要检查它是否使用织梦默认模板解析流程。

六、模板标签与调用方法

1. 引入公共头部和底部

公共部分可以拆成单独模板，避免在每个页面重复维护。常见写法如下：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <title>{dede:field.title/}</title>
  <link rel="stylesheet" href="/templets/mytheme/css/site.css">
</head>
<body>
  {dede:include filename="head.htm"/}

  <main>
    <h1>页面主体</h1>
  </main>

  {dede:include filename="footer.htm"/}
</body>
</html>

{dede:include filename="head.htm"/} 是常见的模板包含写法。被包含文件的位置解析方式可能受版本和模板目录影响；若提示找不到文件，应检查文件是否放在当前风格目录、名称是否正确，以及站点具体版本的 include 规则。不要仅凭网页源代码中出现标签，就认定浏览器会处理它；模板标签必须由织梦生成流程解析。

2. 输出字段

字段标签要放在能够提供对应数据的页面上下文中。以下是常见示意：

<h1>{dede:field.title/}</h1>
<p>栏目：{dede:field name='typename'/}</p>
<p>发布时间：{dede:field.pubdate function="MyDate('Y-m-d',@me)"/}</p>

不同页面可用字段不同，函数调用的可用方式也可能受版本、配置和解析环境影响。不要把某个示例字段复制到所有页面后，假设一定有值。调试时应先确认当前模板类型，再查看同版本自带模板或官方代码中使用的标签写法。

3. 输出文章列表

常见文章列表标签是 dede:arclist。例如：

<ul>
{dede:arclist row='10' titlelen='40' orderby='pubdate' }
  <li>
    <a href="[field:arcurl/]">[field:title/]</a>
    <time>[field:pubdate function="MyDate('Y-m-d',@me)"/]></time>
  </li>
{/dede:arclist}
</ul>

这是用于常见版本的示例，属性含义和可用范围应以当前版本的标签实现为准。row 用于指定查询展示条数，titlelen 用于控制标题长度相关处理，orderby 指定排序依据；不要据此推断所有排序字段都受支持，也不要把任意用户输入直接拼进标签属性。不同标签可能使用不同的属性、字段名和上下文。

列表标签里的 [field:...] 是循环项字段，和页面级的 {dede:field...} 不是同一类上下文。复制标签时若循环项字段没有输出，先检查它是否属于该标签返回的数据，而不是盲目增加字段名称。

4. 栏目列表与分页

栏目列表页常使用 dede:list 输出当前栏目的文档，并配合分页标记。写法会因模板和版本而异，以下示例展示的是常见结构：

<ul>
{dede:list pagesize='20'}
  <li>
    <a href="[field:arcurl/]">[field:title/]</a>
    <span>[field:pubdate function="MyDate('Y-m-d',@me)"/]</span>
  </li>
{/dede:list}
</ul>

<div class="pagination">
  {dede:pagelist listitem="info,index,end,pre,next,pageno" listsize="5"/}
</div>

pagesize、listitem、listsize 等属性在常见版本中用于控制列表或分页呈现，但实际接受的属性、可选项及默认行为应以当前版本实现为准。不要把示例中的数值当作全局强制限制；若需要高页数、大量查询或特殊排序，应结合数据库负载和系统实现测试。

列表页是否出现分页，还与栏目生成设置、文档数量和页面生成方式有关。列表中没有分页时，检查当前栏目是否使用了该列表模板、栏目是否有足够内容、分页标签是否位于解析区域，以及是否重新生成了栏目页面。

5. 面包屑导航

栏目、文章页面常会显示当前位置。部分织梦版本和模板使用 dede:field name='position'/ 一类写法，但标签名称、分隔符和输出 HTML 可能存在差异。使用前应对照站点版本中的默认模板或当前栏目模板，不要将某个模板包里的专有标签当成所有 DedeCMS 都支持。

七、模板路径与静态资源路径

模板文件引用 CSS、JavaScript 和图片时，常见错误是相对路径层级不一致。首页、栏目页和内容页所在 URL 深度可能不同，像 css/site.css 这样的相对路径在不同页面可能指向不同位置。可根据站点部署结构使用以站点根路径为起点的路径，或者正确配置资源基准地址。

<link rel="stylesheet" href="/templets/mytheme/css/site.css">
<script src="/templets/mytheme/js/site.js"></script>

上述以斜杠开头的路径表示从当前域名根路径访问，并不适用于所有安装方式。若站点部署在子目录，例如域名下的 /cms/，直接写 /templets/ 可能会指向错误位置，应按实际站点根目录调整。不要把本地开发机上的绝对磁盘路径写进网页资源地址。

还要区分模板文件路径和浏览器访问路径：模板文件在服务器上的位置，不一定就是可以直接访问的 URL。将敏感配置文件、备份文件放入可公开访问的模板目录，也是不恰当的做法。

八、修改后如何让页面生效

1. 保存模板文件，并确认文件确实上传到了当前使用的风格目录。
2. 在后台核对默认风格以及栏目、内容模板的绑定关系。
3. 通过后台相应的生成或更新功能，重新生成首页、栏目页和需要更新的内容页。
4. 清理浏览器缓存、反向代理缓存或 CDN 缓存（如果站点使用了这些服务）。
5. 查看生成结果的页面源代码，确认模板标签已解析、资源链接有效。

生成菜单的名称和批量生成选项会因版本而不同。大批量重新生成可能占用较多时间和服务器资源，生产站点应先估算范围、在低峰期操作，并观察程序日志和服务器负载。若站点使用动态浏览、静态生成与动态访问混合，应该按该站点实际发布方式验证，不能假定所有页面都由同一入口生成。

九、参数、兼容性与边界

模板标签的参数并非一个通用、固定的参数集合。每个标签有自己的实现，某些属性只在特定版本或二次开发版本中存在；属性值格式、默认值和可用字段也可能不同。本文示例用于说明常见调用结构，不构成对所有版本的兼容承诺。

尤其不要把 row、pagesize、titlelen 等示例属性理解成没有上限、可随意扩大的参数。实际查询条数和页面规模还受程序实现、数据库能力、生成时长及服务器资源影响。若标签不识别某个属性，系统可能忽略它、使用默认行为或产生其他结果，具体取决于版本代码。准确确认方式是检查对应版本的标签实现、官方示例和实际生成结果。

此外，模板解析与 HTML 输出不是自动的安全边界。系统能处理模板标签，不代表任意内容都会自动进行适合 HTML、属性、JavaScript 或 URL 场景的转义。是否转义以及如何处理，取决于数据来源、字段处理和版本实现。展示用户可控内容时应按输出上下文进行安全编码；不要把未经验证的数据直接拼到脚本、事件属性或 URL 中。

十、常见错误与排查顺序

页面仍显示旧样式

依次检查：修改的是不是当前风格目录；首页或栏目是否绑定了另一个模板；静态页面是否重新生成；浏览器、代理或 CDN 是否缓存了旧资源。CSS 文件加载失败时，页面结构可能是新的，但视觉上看起来像没有变化。

栏目页正常，文章页没有变化

列表模板和内容模板是不同配置。编辑对应栏目，检查文章模板；再确认文章所属模型及生成流程。仅更新列表页不会自动更新所有文章详情页。

出现织梦标签原文

这通常说明该文件没有经过预期的模板解析，或标签写法、位置不符合当前版本规则。确认文件是不是由织梦生成流程使用，检查标签拼写、配对标签的开始与结束写法，以及模板是否被放在正确目录。直接用浏览器打开服务器上的模板文件，并不会执行织梦标签。

标签解析后内容为空

检查当前页面是否提供该字段、列表是否有数据、栏目 ID 或其他筛选条件是否正确，以及标签是否支持该属性。字段名称需要和当前内容模型、查询结果相符；也要确认目标文档是否已发布并参与生成。

页面布局错乱或资源 404

打开浏览器开发者工具查看网络请求，检查 CSS、脚本和字体文件的请求地址、响应状态及 MIME 类型。重点排查相对路径、子目录部署、大小写和模板包遗漏文件。Linux 等环境通常区分文件名大小写。

模板上传后生成报错

查看后台错误提示、PHP 错误日志和程序日志，确认模板文件编码、标签闭合、包含文件存在以及服务器权限。不要为了“让模板跑起来”就给整个站点目录设置过宽的写入权限，也不要直接修改系统核心文件而不留备份。

十一、安全与维护建议

• 只从可信来源获取模板，并检查其中是否包含未知脚本、外部资源引用或可疑文件。
• 织梦属于需要结合具体版本和维护状态评估的老牌 CMS。更换模板不能替代程序补丁、依赖检查、后台访问控制和备份策略。
• 模板目录不应保存数据库密码、密钥、备份包或其他不应公开的数据。
• 限制模板文件的写入权限，仅让有需要的管理员账号修改模板；部署时避免让 Web 服务账户拥有不必要的全站写权限。
• 对文章正文、标题、搜索词等外部输入输出时，按 HTML 上下文处理，避免将内容直接拼入脚本或属性。
• 更新生产模板前保留旧版本，并记录改动。出现问题时能够回滚，比在服务器上临时覆盖更可靠。

十二、推荐的更换流程小结

实际操作可以按以下顺序完成：先备份文件与数据库；再确认系统版本、当前默认模板目录和栏目绑定；把新模板放入独立风格目录；先替换或配置一个测试栏目，验证标签、资源路径和页面生成；确认无误后再调整首页、其他栏目和内容页；最后按站点发布方式重新生成页面并检查缓存。

最容易忽略的边界是：模板目录设置、栏目模板绑定和静态页面生成是三件不同的事。默认风格改对了，不代表每个栏目都自动换成新模板；模板文件改好了，也不代表现有静态页面已经更新。把这三项分别核对，再根据当前版本验证标签和参数，通常比反复覆盖文件更容易定位问题。