这个文件是 DedeCMS 网站的首页静态文件,理解它的工作原理和如何管理它,是掌握 DedeCMS 的关键。

(图片来源网络,侵删)
index.html 是什么?
index.html 是当您访问您的网站域名(www.yourdomain.com)时,服务器直接返回给浏览器的一个静态 HTML 文件,它不包含任何 PHP 代码,而是已经生成好的、纯 HTML 格式的网页内容。
为什么使用静态文件?
- 速度快:服务器不需要每次都执行 PHP 代码、查询数据库、生成页面,直接读取文件并发送给用户,极大地减轻了服务器压力,加快了网站访问速度。
- 减轻数据库压力:首页通常访问量最大,静态化后,绝大多数访问都不会直接查询数据库,保护了数据库。
- 利于 SEO(搜索引擎优化):搜索引擎更喜欢抓取和索引静态页面,因为它们结构清晰、加载快。
index.html 是如何生成的?
index.html 不是手动创建的,而是由 DedeCMS 系统根据您设置的首页模板自动生成的,这个过程通常由两种方式触发:
手动生成(最常用)
这是最直接、最常用的方法。

(图片来源网络,侵删)
- 操作路径:登录您的 DedeCMS 后台 -> “生成” -> “首页更新”。
- 具体操作:
- 在“首页更新”页面,您会看到几个选项:
- 首页HTML设置:在这里您可以设置是否生成首页 HTML 文件,以及文件名(通常是
index.html)。 - 选择首页模板:指定哪个模板文件(位于
/templets/default/目录下)来生成首页。 - 生成选项:
- 仅更新主页:只重新生成
index.html。 - 更新所有:重新生成首页、栏目页、内容页等所有静态文件。
- 开始生成:点击此按钮,系统开始执行生成任务。
- 仅更新主页:只重新生成
- 首页HTML设置:在这里您可以设置是否生成首页 HTML 文件,以及文件名(通常是
- 点击“开始生成”后,系统会执行模板引擎,读取您选择的首页模板(如
index.htm),将里面的标签(如{dede:arclist})替换成从数据库中查询到的实际内容,最终生成一个完整的index.html文件,并上传到您网站的根目录。
- 在“首页更新”页面,您会看到几个选项:
自动生成(定时更新)
为了保持首页内容的“新鲜度”,DedeCMS 提供了自动更新首页的功能。
- 操作路径:登录 DedeCMS 后台 -> “系统” -> “系统基本参数” -> “性能选项”。
- 设置项:
- 首页自动更新:选择“是”。
- 首页自动更新间隔:可以设置为“N 分钟”、“N 小时”或“N 天”。
- 工作原理:设置后,系统会按照您设定的时间间隔,自动在后台执行一次“首页更新”的操作,无需您手动干预。
首页模板 (index.htm) 与 index.html 的关系
这是一个非常重要的区别,很多新手会混淆:
| 特性 | index.htm (首页模板) |
index.html (静态首页) |
|---|---|---|
| 位置 | 网站根目录下的 /templets/您的模板目录/ 文件夹中 |
网站根目录(与 index.php 同级) |
| 作用 | “设计稿”或“蓝图”,它定义了首页的布局和内容来源。 | 最终产品,它是根据“蓝图”生成的、可以直接被用户访问的网页。 |
| 可访问性 | 不能直接通过浏览器访问(除非服务器配置特殊)。 | 可以直接通过浏览器访问,是网站的真实首页。 |
简单流程:
设计 (修改 index.htm) -> 生成 (点击后台生成按钮) -> 产出 (生成 index.html) -> 访问 (用户访问网站看到 index.html)。
常见问题与解决方法
问题:为什么我修改了首页内容,但网站没变化?
- 原因:您可能修改的是
index.html文件本身,而不是index.htm模板文件,或者您修改了模板但没有重新生成。 - 解决方法:
- 确认您修改的是
/templets/目录下的index.htm文件。 - 登录 DedeCMS 后台,进入 “生成” -> “首页更新”,点击“开始生成”,重新生成
index.html。 - 如果还是不行,可以尝试删除根目录下的
index.html文件,然后重新生成一次。
- 确认您修改的是
问题:为什么我更新了文章,但首页的文章列表没有显示最新的?
- 原因:首页文章列表通常由
{dede:arclist}等标签调用数据库内容,如果首页是静态的,它只在生成时读取一次数据库。 - 解决方法:发布新文章或更新文章后,必须回到后台 “生成” -> “首页更新”,重新生成一次首页,新的内容才会出现在
index.html中。
问题:我想让首页动态化,不使用 index.html,可以吗?
- 可以,DedeCMS 支持首页动态化。
- 设置方法:
- 登录后台 -> “生成” -> “首页更新”。
- 在“首页HTML设置”中,取消勾选“首页生成HTML”。
- 点击“修改”保存。
- 后果:
- 您的网站首页将不再是
index.html,而是index.php。 - 每次访问首页时,服务器都需要执行 PHP 代码、查询数据库来实时生成页面,这会增加服务器和数据库的负载,访问速度会变慢。
- 这种方式通常只在网站内容极少、或者需要频繁更新且无法接受手动生成操作时使用,对于大多数网站,强烈推荐使用静态化。
- 您的网站首页将不再是
index.html是 DedeCMS 首页的静态化结果,用于提升网站性能和 SEO。- 它由后台的首页模板 (
index.htm) 通过“生成”功能创建。 - 修改网站内容后,必须手动或自动重新生成
index.html,才能让用户看到更新。 - 管理好
index.html的生成和更新,是维护一个高效 DedeCMS 网站的核心工作之一。

(图片来源网络,侵删)
