织梦下载的模板怎么安装：从文件上传到页面调用

给织梦（DedeCMS）网站更换模板，通常不是把压缩包传到服务器、点一下“安装”就完成。模板文件需要放在网站能识别的目录中，再通过模板风格、栏目或文档设置指定要使用的文件，最后重新生成页面。若模板包还包含图片、样式表、脚本或数据库数据，也要分别判断其用途，不能一股脑覆盖现有站点。

本文以常见的 DedeCMS 网站为例，说明从检查模板包、上传文件到页面调用的基本流程。不同版本、二次开发站点和第三方模板包的目录结构可能不同，操作前应以当前站点实际配置为准。尤其是旧版织梦环境，模板安装并不会自动解决程序自身的安全和兼容问题。

一、先判断模板适不适合当前网站

织梦模板适用于已经运行 DedeCMS、希望更换网站页面结构或视觉样式的站点。模板通常由 HTML 结构和织梦模板标签组成，生成静态页面时由 DedeCMS 解析标签、读取栏目和文章数据，再输出最终 HTML。模板不等于完整网站程序，也不一定包含可直接导入的栏目、文章、模型和配置。

下载模板后，先查看压缩包中的说明文件和目录。常见内容包括：

• index.htm：常作为首页模板。
• list_*.htm：常作为栏目列表页模板。
• article_*.htm：常作为文章或内容页模板。
• head.htm、footer.htm：可能是被其他模板引用的头部和底部文件。
• style、css、images、js 等目录：通常放样式、图片和脚本，实际名称以模板包为准。
• install.sql、配置说明或演示数据：可能涉及数据库结构或内容导入，不能仅凭文件名就直接执行。

模板与程序版本、内容模型、栏目结构和字符编码都可能存在依赖。某个模板能被上传，不代表它一定能在当前站点正确显示。拿不准时，先在测试站点验证，并查看模板包提供的版本要求和安装说明。

二、安装前做好备份并确认站点环境

覆盖文件或调整配置之前，至少备份现有模板目录和站点数据库。若模板会覆盖 CSS、图片或公共头尾文件，也要一并备份对应资源。对正在使用的生产站点，建议先复制一份到测试环境，确认首页、栏目页和内容页都正常后再切换。

还要确认网站根目录、模板目录和当前模板风格。常见 DedeCMS 安装中，模板目录名为 templets，默认风格目录常见为 templets/default。但站点可以自定义模板目录，也可能经过搬迁或二次开发，不能把这两个路径当成所有网站都固定不变的路径。

可以先通过主机文件管理器或 FTP/SFTP 查看网站根目录，确认是否能看到 templets。再登录 DedeCMS 后台，查看系统基本参数中的“模板默认风格”或类似设置。不同版本后台菜单名称可能略有差异；若界面与本文描述不一致，应以所用版本的后台和官方文档为准。

三、解压模板包，找到真正的模板根目录

不要直接把整个压缩包随手上传到网站根目录。先在本地解压，并检查目录层级。常见的压缩包可能是以下两种结构：

template-package/
├── templets/
│   └── mytheme/
│       ├── index.htm
│       ├── list_article.htm
│       ├── article_article.htm
│       ├── head.htm
│       └── css/
└── readme.txt

也可能压缩包打开后第一层就是模板文件：

mytheme/
├── index.htm
├── list_article.htm
├── article_article.htm
├── head.htm
└── css/

关键是弄清要上传的是哪一层。若误把外层目录也套进去，最终路径可能变成 templets/mytheme/mytheme/index.htm，后台设置却指向 templets/mytheme，页面就会提示找不到模板或仍然使用旧模板。

还要检查模板引用的资源路径。例如页面中若引用 /templets/mytheme/css/site.css，就要保证服务器上确实存在对应文件。某些模板写的是相对路径，路径相对于生成页面的位置时可能不同；栏目页和内容页层级不同时，资源链接尤其容易失效。后文会提供一种使用模板目录变量的写法，但旧模板未必已经这样处理。

四、通过 FTP/SFTP 上传模板文件

建议使用 SFTP 或主机商提供的安全文件管理方式上传。连接站点后，进入实际网站根目录，再把模板文件放进一个独立的风格目录，例如 templets/mytheme。尽量不要直接覆盖正在使用的 templets/default，这样便于回退，也不容易把原站点的公共文件覆盖掉。

示例目录结构如下，实际目录名可以不同：

网站根目录/
└── templets/
    ├── default/
    └── mytheme/
        ├── index.htm
        ├── list_article.htm
        ├── article_article.htm
        ├── head.htm
        ├── footer.htm
        ├── css/
        ├── images/
        └── js/

上传后逐项检查文件数量、目录层级和文件名大小写。Linux 服务器通常区分大小写：模板里写了 Logo.png，服务器上的文件若名为 logo.png，就可能加载失败。通过 FTP 传输时，也应避免误用会改变文件内容的传输模式；HTML、CSS、JavaScript 和图片通常应按原始内容传输。

目录权限不宜为了“让它能访问”而随意设为所有用户可写。模板静态文件一般只需服务器可读取；是否需要写入权限取决于主机运行用户、缓存目录等具体配置。不要通过大范围开放写权限来掩盖权限配置问题。

五、在后台设置模板默认风格

模板文件上传后，需要让 DedeCMS 知道使用哪个风格目录。常见做法是在后台系统基本参数中，把“模板默认风格”设置为新目录名称，例如 mytheme。如果当前版本显示的是完整路径或不同字段名，应按后台实际提示填写，不要机械照抄示例。

常见配置逻辑是：风格目录位于 templets 下，后台选择的风格名对应子目录。也就是说，选择 mytheme 后，系统会到相应模板目录中查找模板文件。请确认 mytheme 的拼写与服务器上的目录名一致。

改变默认风格通常只影响默认模板选择，不一定会覆盖每个栏目或每篇文档单独指定的模板。如果后台设置后某个栏目仍显示旧样式，继续检查该栏目的模板配置；如果只有某篇文章异常，还要检查文档本身是否单独指定了内容页模板。

六、理解模板文件如何被页面调用

织梦模板不是只靠文件名自动应用。系统会根据页面类型、栏目设置、文档设置和模板风格去选取相应模板。常见文件名包括 index.htm、list_article.htm 和 article_article.htm，但具体命名与栏目内容模型、站点设置和程序版本有关。

• 首页：通常使用风格目录下的 index.htm。生成首页后才能检查最终结果；仅上传文件不等于首页已经重新生成。
• 栏目列表页：通常由栏目设置中的列表模板决定。某些常见安装会使用与内容模型相关的 list_*.htm 文件，但栏目也可能指定其他模板。
• 内容页：通常由文档所属模型、栏目设置或文档自身的模板设置决定。常见文件名有 article_*.htm，实际对应关系要结合站点配置。
• 公共头部和底部：模板可能用织梦的 include 标签引入，例如 head.htm、footer.htm。只有被其他模板引用的文件才会参与对应页面输出。

下面是一个简化的首页模板片段，展示织梦标签与普通 HTML 的混合方式。模板标签要由 DedeCMS 解析；如果把它当成普通静态 HTML 文件直接打开，标签通常不会变成栏目或文章数据。

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

  <main>
    <h1>{dede:global.cfg_webname/}</h1>

    <ul>
      {dede:arclist row='6'}
      <li>
        <a href="[field:arcurl/]">[field:title/]</a>
      </li>
      {/dede:arclist}
    </ul>
  </main>

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

这里的 cfg_webname 和 cfg_templets_skin 是常见织梦全局配置标签用法。具体标签是否可用、输出值如何以及模板解析行为，仍取决于当前程序版本和站点配置。若页面原样显示大括号标签，优先确认当前 URL 是否由织梦生成、模板是否被该页面实际调用，以及标签是否写在当前模板引擎支持的位置。

arclist 是常见的文章列表标签示例。示例中的 row='6' 表示请求输出 6 条记录；这不是对所有查询、页面或标签的通用上限说明，也不代表数据库中只能有 6 条文章。实际可用属性和边界应参考对应版本的标签文档。不要把某个标签的参数限制推断成整个织梦系统的统一限制。

七、栏目页和内容页模板示例

一个简单的栏目列表模板可以包含栏目名称、文章链接和分页标签。下面仅演示常见写法，字段是否适用于当前模型、标签属性是否与当前版本一致，都应在测试环境中验证。

<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <title>{dede:field name='typename'/} - {dede:global.cfg_webname/}</title>
  <link rel="stylesheet" href="{dede:global.cfg_templets_skin/}/css/site.css">
</head>
<body>
  {dede:include filename="head.htm"/}

  <main>
    <h1>{dede:field name='typename'/}</h1>

    <ul>
      {dede:list pagesize='10'}
      <li>
        <a href="[field:arcurl/]">[field:title/]</a>
      </li>
      {/dede:list}
    </ul>

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

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

此例中的 pagesize='10' 是列表标签的一个常见用法，不应理解为所有版本、所有页面的固定参数上限。分页展示还要求页面使用相应的列表生成逻辑；把分页标签放进不适用的页面模板中，不会自动产生完整分页。具体参数含义和支持情况应查对应版本文档。

一个简化的内容页可以这样组织：

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

  <main>
    <article>
      <h1>{dede:field.title/}</h1>
      <div class="article-body">
        {dede:field.body/}
      </div>
    </article>
  </main>

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

{dede:field.body/} 一般用于输出文档正文。若当前内容模型字段名、模板标签或站点二次开发方式不同，照搬示例可能出现正文为空。模板作者也可能使用其他字段或自定义标签，应按实际模型核对。

八、配置栏目和文档的模板选择

默认风格设置完成后，进入相应栏目编辑页面，检查列表模板和内容模板字段。部分站点在新建栏目时已经指定过模板，系统默认风格变化后它们仍可能继续使用原配置。选择模板文件时，要确认文件存在于当前风格目录下，而且文件名与实际拼写一致。

内容页还可能受内容模型影响。文章、图集、软件、商品等模型的字段结构与模板需求不同；把面向普通文章模型的模板直接用于其他模型，可能造成字段缺失、页面空白或标签无输出。遇到这种情况，应使用与模型匹配的模板，或按模型字段改写模板。

如果只希望首页换样式，可以先仅切换首页模板并生成首页，不必马上覆盖所有栏目设置。若要整站换肤，再逐个检查栏目和文档模板。分阶段操作更容易定位问题，也方便及时恢复。

九、生成页面、更新缓存并检查结果

模板更改后，通常要在后台执行相应的更新或生成操作，具体菜单名称依版本而异。常见流程是先更新系统缓存或模板相关缓存，再生成首页、栏目页和内容页。静态页面站点若只改了模板而没有重新生成，访问者仍可能看到服务器上旧的静态 HTML。

检查时至少打开首页、一个栏目列表页、一个内容页，以及分页中的后续页面。重点观察页面结构、链接地址、CSS 和图片加载、正文输出、导航状态和分页是否正常。还可以使用浏览器开发者工具查看资源请求状态，区分是模板没有调用，还是样式文件路径错误。

若页面样式没有更新，可以尝试清理站点生成的缓存或重新生成相应页面，并清理浏览器缓存。若问题只发生在个别栏目或文章，优先检查该栏目或文档是否单独设置了模板，而不是反复覆盖整套模板文件。

十、常见错误及排查顺序

1. 模板仍然显示旧样式

检查后台的默认风格是否保存成功、栏目或文档是否有单独模板配置，以及静态页面是否已经重新生成。然后确认访问的是当前站点和正确域名，避免将测试站与生产站混淆。

2. 提示找不到模板文件

检查模板根目录是否多套了一层、后台风格目录名是否拼写一致、文件扩展名是否正确，以及大小写是否一致。也要留意模板包解压后是否把文件放在了错误的子目录。

3. 样式和图片全部丢失

检查模板引用的 URL 与服务器实际路径。若 CSS 文件路径写死在旧站域名或旧目录中，搬站后就会失效。逐个查看浏览器资源请求地址和服务器上的文件位置，再调整模板中的路径。

4. 模板标签以原样显示或没有数据

确认页面是由织梦生成的，而不是直接访问上传的 .htm 文件；确认所用模板属于当前页面类型；确认标签写法和字段名适用于当前版本与内容模型。若只有某个列表为空，还要检查当前栏目是否有符合条件的数据。

5. 首页正常，栏目页或内容页不正常

这通常说明问题不在首页模板本身。逐个检查栏目列表模板、内容模型模板及具体栏目或文档的单独设置，并验证相应模板文件是否存在。

6. 中文乱码或标题截断

检查模板文件编码、页面声明的字符集、数据库和程序的字符集配置是否一致。不要在不了解影响的情况下批量转换整个模板目录编码。标题截断可能与标签参数、程序实现或显示样式有关，不能仅凭视觉效果判断是哪一种原因；应先检查具体标签配置和生成结果。

十一、安全边界：模板文件不是天然可信的静态资源

模板包来自第三方时，应把其中的 PHP 文件、可执行脚本、数据库脚本和带有程序逻辑的模板标签视为需要审查的代码，而不是普通图片或 CSS。织梦模板功能可能包含动态标签，也可能在某些环境中涉及 PHP 执行或扩展能力；具体行为取决于程序版本、配置和模板内容。不能因为文件扩展名是 .htm 就认定它绝对安全。

安装前检查压缩包来源和文件清单。对于不认识的 PHP 文件、可疑的外部跳转、混淆代码、远程加载脚本、要求输入站点密码的安装器或未经解释的数据库脚本，不要直接放到生产站点执行。必要时由有经验的维护人员检查代码，并在隔离的测试环境中验证。

模板代码可能输出文章标题、正文和其他用户可编辑内容。若模板自行拼接用户输入、查询参数或表单内容，必须按具体输出上下文进行恰当处理，不能假设织梦会自动替所有自定义代码完成安全转义。不要在模板中硬编码数据库密码、密钥或其他秘密，也不要把后台凭据写进可公开访问的文件。

安装模板不会自动加固 DedeCMS。旧版程序和长期未维护的插件可能存在安全风险。应根据站点实际版本评估更新、访问控制、备份和运行环境，并限制后台与可写目录的访问。若模板要求修改核心文件，应先确认必要性、记录改动并保留可回滚备份；优先使用模板配置和可维护的扩展方式。

十二、推荐的实际操作清单

1. 核对模板包说明、适用版本、栏目模型和所需资源。
2. 备份数据库、现有模板目录及可能被覆盖的静态资源。
3. 在本地解压，确认模板根目录和文件层级。
4. 将新模板上传到独立目录，例如 templets/mytheme，不要盲目覆盖默认模板。
5. 检查模板引用的 CSS、图片和脚本文件路径是否真实存在。
6. 在后台设置默认模板风格，并检查栏目、内容模型和文档的单独模板配置。
7. 更新必要缓存，生成首页、栏目页和内容页。
8. 在浏览器中逐页检查链接、样式、内容和分页，并排查控制台及资源请求错误。
9. 确认第三方代码安全、站点可回滚后，再应用到正式环境。

织梦模板安装的核心，是让模板目录、后台风格设置、页面类型和栏目或文档配置彼此对应。上传只是其中一步。按“先备份、再上传、后配置、再生成、逐页验证”的顺序操作，通常比直接覆盖旧目录更稳妥；碰到版本差异或模板包说明不清的情况，先在测试站点确认，不要把猜测当成通用规则。