核心概念
在 DedeCMS 中,模板的加载路径主要由以下几个核心配置决定:

- 默认模板目录 (
templets):这是系统默认的模板根目录,所有未特别指定的模板文件都会在这里寻找。 - 系统配置 (
dede_sysconfig):数据库中的一张表,存储了网站的全局配置,其中就包括默认模板目录的路径。 - 栏目/频道配置:每个栏目或频道模型都有自己独立的模板设置,可以覆盖系统默认设置。
- 模板标签:在模板文件中,通过
{dede:include}等标签可以引入其他模板文件,其路径是相对于当前模板文件的。
修改默认模板目录主要有两种方式:
- 方式一(推荐):通过后台系统设置修改。 这是最标准、最安全的方法,会同步更新数据库配置。
- 直接修改配置文件。 适用于需要临时修改或进行二次开发的情况。
通过后台系统设置修改(推荐)
这是最常用且最安全的方法,修改会立即生效,无需手动修改文件。
步骤 1:登录后台
使用管理员账号登录你的 DedeCMS 后台。
步骤 2:进入系统基本参数设置
在后台左侧菜单中,找到并点击 【系统】 -> 【系统基本参数】。

步骤 3:修改模板默认目录设置
在打开的页面中,切换到 【核心设置】 选项卡。
向下滚动,找到 “模板默认目录” 这一项,默认值通常是 templets。
步骤 4:输入新的目录名并保存
- 在输入框中,将
templets修改为你想要的新目录名,my_templates或v1。 - 点击页面底部的 【保存】 按钮。
步骤 5:创建新目录并移动模板文件
- 创建目录:通过 FTP 或你的主机控制面板的文件管理器,进入网站的根目录(通常是 ),找到
templets文件夹。 - 创建新目录:在
templets文件夹内,创建一个与你刚才设置的新名称完全相同的文件夹(my_templates)。 - 移动文件:将原来
templets文件夹下的所有文件和文件夹(如default、style等)移动到新创建的my_templates文件夹中。
重要提示: 是移动文件,而不是复制,移动后,原来的 templets 文件夹可以为空,也可以删除,但建议保留以备不时之需。
步骤 6:验证效果
完成以上步骤后,清空浏览器缓存,然后刷新你的网站前台页面,网站应该能正常显示,并且加载的是你新目录下的模板文件。

直接修改配置文件(不推荐常规使用)
如果你无法登录后台,或者需要进行程序级的修改,可以直接操作数据库或配置文件。
方法 A:修改数据库(与方式一原理相同)
- 登录你的网站数据库管理工具(如 phpMyAdmin)。
- 找到你的 DedeCMS 数据库。
- 在数据表中找到名为
dede_sysconfig的表。 - 在该表中,找到
varname字段值为templetspath的记录。 - 修改该记录的
value字段值,将其从/templets修改为/你的新目录名(/my_templates)。 - 保存修改,之后同样需要创建新目录并移动模板文件。
方法 B:修改 PHP 配置文件(config_base.php)
-
通过 FTP 或文件管理器,进入网站根目录下的
/include文件夹。 -
找到并编辑
config_base.php文件。 -
搜索
$cfg_templets_dir这一行。 -
修改它的值,
// 修改前 // $cfg_templets_dir = $cfg_cmspath.'/templets'; // 修改后 $cfg_templets_dir = $cfg_cmspath.'/my_templates';
-
保存文件,之后同样需要创建新目录并移动模板文件。
注意: 此方法会与后台的“系统基本参数”设置冲突,如果你在后台修改了默认模板目录,这个文件里的设置可能会被覆盖。强烈建议优先使用方式一。
高级应用:为不同栏目设置不同模板目录
很多时候,我们修改默认模板目录是为了给特定栏目使用不同的主题,DedeCMS 本身就支持强大的模板覆盖机制,你无需修改全局默认目录。
假设你有两个模板目录:templets/default (默认主题) 和 templets/blue_theme (蓝色主题)。
目标: 让“产品中心”栏目使用 blue_theme 主题。
步骤:
-
准备模板文件:确保
templets/blue_theme目录下有完整的模板文件,包括index.htm(首页)、list_article.htm(列表页)、article_article.htm(文章页) 等,文件名必须和default目录下的一致。 -
登录后台并进入栏目管理:在后台左侧菜单,点击 【栏目】 -> 【栏目管理】。
-
选择目标栏目:在栏目列表中,找到并点击你想要修改的栏目,产品中心”。
-
修改栏目模板设置:
- 在栏目编辑页面,向下滚动到 管理” 部分。
- 你会看到“列表模板”、“文章模板”等选项。
- 不要直接填写文件名,而是要在文件名前加上模板目录的路径。
- 在“列表模板”输入框中,填写:
blue_theme/list_article.htm - 在“文章模板”输入框中,填写:
blue_theme/article_article.htm - 如果首页模板也需要指定,可以填写
blue_theme/index.htm。
-
保存:点击页面底部的 【保存】 按钮。
当你访问“产品中心”栏目时,DedeCMS 会自动去 templets/blue_theme/ 目录下寻找对应的模板文件,而其他栏目仍然会使用默认的 templets/default/ 目录。
总结与注意事项
| 修改方式 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| 后台系统设置 | 安全、标准、即时生效 | 需要额外手动移动文件 | 所有常规需求,更换整个网站的主题。 |
| 直接修改文件 | 无需登录后台 | 有风险,可能和后台设置冲突 | 无法登录后台的紧急修复,或二次开发程序控制。 |
| 栏目单独设置 | 灵活、强大、不影响全局 | 需要为每个指定栏目手动配置 | 为不同频道、不同栏目使用不同模板(如PC端/移动端、不同业务线)。 |
重要注意事项:
- 文件权限:确保你的 web 服务器(如 Apache/Nginx)对
templets目录及其子目录有读取权限。 - 路径问题:在指定栏目模板时,路径是相对于
templets目录的。templets/blue_theme/list.htm,在后台只需填写blue_theme/list.htm。 - 缓存问题:修改模板后,如果页面没有更新,可以尝试在后台 【系统】 -> 【一键更新网站】 -> 更新HTML 或清除缓存。
- 备份:在进行任何文件或数据库修改之前,请务必备份你的网站文件和数据库,以防出错。
希望这份详细的指南能帮助你成功修改 DedeCMS 的默认模板目录!
