织梦教程：修改网站首页模板的基本步骤

织梦（DedeCMS）网站的首页通常由模板文件生成。调整首页栏目、文章列表、导航或页面布局，常见做法是修改首页模板，再通过后台更新首页 HTML。看起来只是编辑一个文件，实际还涉及模板目录配置、标签解析、静态文件覆盖和缓存等环节。若没有确认当前站点使用的模板和首页发布方式，改对文件也可能看不到效果。

本文介绍一套相对稳妥的操作流程，并说明哪些设置会因 DedeCMS 版本、二次开发或服务器配置而不同。示例面向常见的 DedeCMS 5.7 系列及相似安装，不代表每个站点的目录和后台菜单都完全一致。动手前应先确认站点实际配置，尤其不要把示例路径当成固定路径。

一、什么情况下需要修改首页模板

以下需求通常可以通过首页模板完成：

• 调整首页的 HTML 结构、标题、导航、页脚和区块顺序。
• 展示指定栏目中的文章列表、推荐内容或栏目链接。
• 修改首页的静态资源引用，例如 CSS、JavaScript 和站点标志的路径。
• 增加网站介绍、公告等固定内容，或为现有标签调整参数。

首页模板不一定适合所有改动。若需求涉及新增数据字段、改变内容录入流程、实现复杂筛选或调用外部服务，通常需要评估是否要改后台、插件或程序逻辑。只在模板里拼接数据库查询，可能带来性能和安全问题。若只是首页内容没有更新，也不应先改模板：应先检查生成流程、缓存和站点实际访问的文件。

二、先确认模板目录和首页发布方式

织梦常见模板目录为站点根目录下的 templets/default/，其中可能有 index.htm、head.htm、footer.htm 等文件。default 是常见的默认风格目录，但站点可以使用其他风格名称；目录位置、模板文件名也可能被二次开发修改。因此要以站点配置和现有文件为准。

可按以下顺序确认：

1. 在后台查看模板相关配置，确认默认模板风格或模板目录名称。不同版本的菜单名称可能不同。
2. 查看站点根目录和模板目录，确认首页模板文件实际存在的位置。不要只凭网上教程中的路径判断。
3. 查看首页更新设置及服务器默认首页配置，判断访问首页时读取的是静态首页文件还是由程序动态处理。
4. 如果站点经过定制，查找当前首页模板的引用关系和部署说明，确认修改的是生产环境正在使用的副本。

不少织梦站点以 index.htm 作为首页模板，后台执行更新首页后生成根目录的 index.html。但这是常见工作流，不是所有站点都如此：有的站点通过动态方式访问，有的改了生成文件名或入口，还有的服务器会优先读取 index.php。最终展示哪个文件，还受服务器配置中的默认首页顺序影响。

因此，修改之前先记录当前首页地址、文件更新时间和服务器默认首页配置。若根目录同时存在 index.html 和 index.php，不要仅凭文件名猜测访问逻辑。可以在测试环境查看页面响应、检查服务器配置，或让运维人员确认实际入口。

三、备份、测试和回退准备

模板即使是文本文件，也可能包含大量布局和业务标签。错误的标签闭合、编码变化或误删公共引用，都会造成首页空白或显示异常。正式修改前建议：

• 备份准备修改的模板文件，以及相关头部、页脚文件。
• 通过版本控制或文件对比记录原始内容，至少保留一份可直接恢复的副本。
• 尽可能先在测试站验证。测试站应避免连接生产数据库，或至少确保不会误改生产内容。
• 确认备份可用，并记录修改前的首页生成方式和关键配置。

如果通过 FTP 或控制面板编辑文件，应确认保存编码与原文件兼容。旧站点常见 GBK 等编码，直接用编辑器转换成 UTF-8 可能导致中文乱码。是否使用 UTF-8，应依据文件原编码、页面声明和站点整体配置决定；不要在没有检查的情况下统一转换。

四、修改首页模板的基本步骤

步骤 1：复制模板并做小范围修改

找到实际生效的首页模板，先复制为备份文件。建议一次只做一个明确改动，例如先加一个标题，再验证输出；确认无误后再调整文章列表。这样更容易定位问题。

首页模板常用 HTML 结构，也可能包含织梦模板标签。以下示例展示一个简单的首页区块和文章列表。示例中的标签参数是常见写法，实际字段、栏目 ID 和站点标签要按当前系统数据调整。

<section class="home-news">
  <h2>最新文章</h2>
  <ul>
    {dede:arclist row="8" orderby="pubdate"}
      <li>
        <a href="[field:arcurl/]">[field:title/]</a>
        <time>[field:pubdate function="MyDate('Y-m-d',@me)"/]></time>
      </li>
    {/dede:arclist}
  </ul>
</section>

{dede:arclist} 是织梦常见的文章列表标签，row 用于指定该列表请求的条数，orderby 指定排序依据。示例采用发布时间排序。标签可用参数、可用排序字段及具体行为，可能受版本、补丁和二次开发影响；应以本站模板标签说明、现有模板和实际测试为准。

row="8" 是示例请求条数，不意味着所有版本都保证返回 8 条。若符合条件的文章不足，结果会少于 8 条；若没有符合条件的文章，列表可能为空。不要把列表条数理解为数据库查询的安全限制或性能保证。条数设置过大可能增加查询和页面输出负担，首页列表宜按实际展示需要控制。

需要限定栏目时，常见做法是在标签上增加 typeid 参数，例如：

{dede:arclist typeid="2" row="8" orderby="pubdate"}
  <li><a href="[field:arcurl/]">[field:title/]</a></li>
{/dede:arclist}

这里的 2 是栏目 ID 示例，应替换成本站真实栏目 ID。栏目 ID 通常是整数标识，不是栏目名称，也不是任意 URL。设置参数前应在后台确认栏目，避免首页内容来自错误栏目。若要包含子栏目或实现更复杂的栏目范围，参数名称和行为可能因标签类型、版本而异，应核对本站支持的标签写法，不要凭相似语法推断。

步骤 2：处理公共头部和页脚

常见模板会通过包含标签复用头部、页脚等文件。例如：

{dede:include filename="head.htm"/}
<main class="home">
  <h1>网站首页</h1>
  <p>这里是首页内容。</p>
</main>
{dede:include filename="footer.htm"/}

包含文件的目录解释和可用范围应以当前站点的模板配置为准。若首页已有头部或页脚，不要重复添加一份，否则可能出现重复导航、重复标题、重复脚本或嵌套结构错误。修改公共文件会影响所有引用它的页面；只想改首页时，先确认该文件是否也被栏目页、文章页使用。

页面的 <title>、字符集声明、CSS 和脚本引用通常在头部模板或首页模板中。若需要调整，先检查是否已经由公共头部输出。不要在页面中重复声明冲突的字符集，也不要为了改变浏览器标题而忽略后台配置或模板中的动态标题逻辑。

步骤 3：检查模板标签和 HTML 结构

保存前逐项检查开始标签、结束标签和织梦标签是否成对。尤其注意：

• 织梦区块标签是否有对应结束标签，例如 {dede:arclist} 与 {/dede:arclist}。
• 列表字段标签是否写在对应的列表循环内部。
• 引号是否完整，HTML 属性是否正确闭合。
• 模板文件中有没有误删公共区域、字符集声明或必要的资源引用。
• 是否把浏览器最终 HTML 与模板源文件混为一谈。模板标签经解析后才会形成页面输出。

不要把用户输入、文章字段或 URL 不经检查地拼入 JavaScript、HTML 属性或脚本代码。模板标签负责取值，不代表输出必然经过适合当前上下文的转义。转义要求取决于输出位置：HTML 文本、属性、URL 和 JavaScript 字符串的处理方式不同。对需要展示的用户内容，应确认系统在对应位置采用了合适的过滤和编码；不能仅依赖“模板会自动安全处理”的假设。

步骤 4：保存后生成首页

若站点采用静态首页，修改模板后通常还需要通过后台的生成或更新功能重新生成首页 HTML。不同版本后台菜单名称有所差异，常见入口在生成相关菜单下，功能名称可能类似“更新主页 HTML”。按后台表单确认生成范围、首页模板及目标文件，再执行更新。

生成操作会写入目标首页文件，可能覆盖此前手工编辑的静态页面。因此首页的结构性改动应放在模板中，再由系统生成；不要把生成后的 index.html 当作模板长期手工维护，否则下一次更新可能覆盖修改。执行前确认目标路径，防止把测试环境生成到生产目录，或反过来。

若站点采用动态首页，或已改造生成逻辑，静态生成可能不是正确步骤。应先依照站点当前运行方式更新缓存或执行对应发布流程，不要盲目反复生成。模板缓存、页面缓存和浏览器缓存是不同层次；刷新浏览器不能替代后台重新生成，重新生成也不一定清除所有缓存。

步骤 5：验证实际访问结果

更新后至少检查以下内容：

1. 用浏览器打开正式首页，确认访问到的是预期文件和站点环境。
2. 强制刷新页面，必要时清理浏览器缓存；若使用 CDN 或反向代理，再检查其缓存策略。
3. 查看页面源代码，确认模板标签已解析，没有把大括号标签原样输出。
4. 检查文章链接、标题、日期、图片和栏目范围是否正确。
5. 检查桌面和移动端布局、浏览器控制台错误，以及页面是否出现重复头部或缺失样式。
6. 在后台再次更新首页，确认修改确实保存在模板中，而不是只改了生成结果。

若页面异常，应优先恢复备份或撤销最近一次小改动，再逐步排查。不要在生产站点连续进行多项猜测性修改。

五、常见需求和容易忽略的边界

控制文章列表的条数和排序

列表条数应按首页设计设置，不能用它代替分页。首页一般是固定数量的摘要列表；需要翻页浏览时，应使用适合的栏目列表或专门的分页页面。排序值不是自然语言描述，必须使用当前标签支持的字段或选项。常见示例中的 pubdate 只是按发布时间排序的写法，若本站版本或二次开发不支持该值，可能排序无效或输出不符合预期。

调整栏目范围

typeid 指向栏目标识，不应直接将访客传入的任意文本拼成标签参数。若栏目范围需要随用户请求变化，应由经过审查的程序逻辑处理，并对输入做类型校验和权限检查；纯模板参数适合固定配置，不适合承担复杂的访问控制。

添加摘要或其他字段

列表中可展示标题、链接、日期等字段，但字段是否可用取决于标签和数据结构。不要假设某个字段名称在所有模板标签中都存在。可先参考同站已有模板和对应版本文档，或者在测试环境用少量数据验证。若字段来自编辑器输入，输出时还应考虑 HTML 清理和上下文编码，避免将不可信内容直接插入属性或脚本。

修改首页标题与 SEO 内容

首页的标题、描述和关键词可能来自模板固定文本、系统配置、全局标签或二次开发逻辑。先查清现有输出来源，再修改其中一处；多处同时输出可能形成重复或互相覆盖。不要把关键词堆砌当作模板优化，也不要把后台配置和模板字段混用后不做验证。改完应检查浏览器页面源代码中的实际 <title> 和描述标签，而不是只看编辑器内容。

六、安全注意事项

DedeCMS 属于历史较久的内容管理系统，不同版本和补丁状态的安全状况并不相同。若站点仍在运行，应先确认具体版本、已安装补丁、插件来源和暴露的后台入口，并依据可信的官方公告或维护渠道制定升级方案。不能仅凭“版本号看起来较新”就断定安全，也不要直接在生产环境覆盖程序文件。升级前必须备份文件和数据库，并在隔离测试环境验证兼容性。

修改首页模板时，安全重点包括：

• 不要在模板中写入数据库密码、后台凭据、API 密钥等秘密信息。
• 不要复制来源不明的 PHP 代码、模板插件或所谓一键修复脚本到生产站点。
• 不要通过模板拼接未经校验的请求参数执行数据库查询或文件操作。
• 确保编辑和部署账号只拥有完成工作所需的权限；模板文件不应设置成所有用户可写。
• 内容输出应按 HTML 文本、属性、URL、脚本等上下文采取适当过滤和编码，且应由可信代码路径实现。

模板参数（例如 row、typeid）是模板功能配置，不是安全机制。将列表条数设小不能防止 SQL 注入，将栏目 ID 写死也不能代替权限校验。若需要在模板中呈现未经信任的内容，应先确认其数据来源和处理方式；遇到无法确认的代码，先在测试环境审查，不要以生产首页作为试验场。

七、常见错误及排查顺序

改完看不到变化

常见原因包括：改错模板目录、首页使用另一套风格、静态首页没有重新生成、服务器优先读取另一个默认首页文件、页面缓存未刷新，或发布到了错误的站点目录。排查时依次确认模板配置、生成目标、服务器默认首页顺序和缓存，不要一开始就重复修改模板。

首页出现模板标签原文

如果页面直接显示 {dede:arclist} 等字符串，可能是文件不是由织梦模板引擎解析、标签写法不受当前系统支持，或模板文件被放到了错误位置。静态 HTML 文件不会自动解析模板标签。应确认修改的是模板源文件，并通过站点对应的生成或动态处理流程输出。

页面空白或生成失败

检查标签是否缺少结束标记、包含文件是否找不到、模板编码是否被意外改变，以及 PHP 错误日志和织梦生成提示。生产环境不要为了排错长期开启错误信息直接输出，因为报错可能暴露路径或内部信息；应在受控测试环境查看日志。

中文乱码

检查文件编码、页面字符集声明、数据库连接编码和编辑器保存方式。不要只改 HTML 中的字符集声明来“修复”乱码；声明与实际字节编码不一致反而会造成更多问题。优先恢复原编码，再按站点整体方案迁移编码。

文章列表为空或顺序不对

检查栏目 ID 是否正确、栏目是否有可发布内容、内容状态是否符合当前列表标签的取数规则，以及排序参数是否受当前版本支持。生成后仍为空时，可以先去掉栏目限制或改用站点已有的同类标签进行对照，但应在测试环境操作，避免不小心展示不应公开的内容。

标题或链接被截断、布局错乱

先查看生成后的 HTML，区分是数据内容、标签输出还是 CSS 导致的问题。长标题是否换行、摘要是否截断，可能由模板字段处理或样式决定。不要直接用字符串拼接来修补乱码或截断；确认字段规则和页面样式后再改。

八、一个精简的检查清单

• 我确认了站点真正使用的模板目录和首页入口。
• 我备份了模板及相关公共文件，并保留回退方式。
• 我确认了标签语法、栏目 ID 和字段在本站可用。
• 我没有把生成后的首页文件当作长期模板源文件。
• 我确认了静态生成或动态更新流程，并知道目标文件会不会被覆盖。
• 我检查了页面源代码、内容范围、链接、编码和移动端显示。
• 我没有把模板参数误当成输入校验或安全防护。

结语

修改织梦首页模板的核心，是先确认“哪个模板在生效、首页如何输出”，再做可回退的小幅修改，最后通过正确流程生成并检查实际页面。文章列表标签适合展示固定范围的内容，但其参数和字段能力要以站点版本为准；模板也不应替代权限控制、输入校验和安全编码。把模板、生成文件、缓存与服务器入口区分开，通常就能避免大部分“改了却没变化”或“更新后被覆盖”的问题。