第一部分:本地环境搭建
织梦是一个基于 PHP + MySQL 的网站程序,所以我们需要在本地电脑上模拟一个服务器环境,最简单、最常用的方法是使用集成环境包。

(图片来源网络,侵删)
推荐工具:集成环境包
集成环境包已经帮你配置好了 Apache/Nginx (Web服务器)、PHP、MySQL (数据库) 等软件,一键安装,非常方便。
-
选择一个集成环境包:
- phpStudy (Windows首选): 对中文用户非常友好,界面简洁,一键切换 PHP 版本和 Apache/Nginx,自带数据库管理工具,强烈推荐 Windows 用户使用。
- 下载地址:https://www.xp.cn
- MAMP (Mac用户首选): Mac 平台下的经典集成环境。
- 宝塔面板 (Linux/Windows/Mac): 功能更强大的服务器管理面板,不仅可以本地使用,也可以直接管理云服务器,适合有一定基础或想学习服务器管理的用户。
- 下载地址:https://www.bt.cn/
- phpStudy (Windows首选): 对中文用户非常友好,界面简洁,一键切换 PHP 版本和 Apache/Nginx,自带数据库管理工具,强烈推荐 Windows 用户使用。
-
安装步骤(以 phpStudy 为例):
- 下载对应你系统版本的 phpStudy (
phpstudy_pro.zip)。 - 解压压缩包,双击运行
phpstudy.exe。 - 第一次启动时,它会自动安装所需的组件,耐心等待即可。
- 安装成功后,你会看到一个管理界面,确认 Apache 和 MySQL 服务已经启动(状态为“运行中”)。
- 下载对应你系统版本的 phpStudy (
第二部分:安装织梦CMS
环境准备好后,我们就可以把织梦程序放进去并安装了。

(图片来源网络,侵删)
下载织梦CMS程序
- 访问织梦官方下载页面:https://www.dedecms.com/
- 下载最新的稳定版本(
DedeCMS-V5.7.110-UTF8.zip),对于本地测试,UTF-8编码版本是首选,兼容性更好。
将程序放置到网站根目录
- 在 phpStudy 中,找到 “网站” -> “管理” -> “打开根目录”,这会打开一个文件夹,通常是
WWW或www目录。这个目录就是你的本地网站服务器根目录。 - 将你下载的织梦压缩包(
.zip)解压,然后将其中的dede文件夹内的所有文件和文件夹,全部复制并粘贴到刚刚打开的WWW目录中。- 注意: 不要把
dede这个文件夹本身放进去,而是要把它里面的内容放进去,最终你的WWW目录结构应该类似这样:/WWW ├── /a ├── /dede ├── /images ├── /include ├── /install ├── /plus ├── /special ├── /templets ├── /uploads ├── index.html ├── index.php └── ... (其他织梦文件)
- 注意: 不要把
创建数据库
织梦需要一个数据库来存储网站内容(文章、分类、用户信息等)。
- 在 phpStudy 界面,找到 “数据库” -> “管理” -> “phpMyAdmin”,这会在你的浏览器中打开数据库管理工具。
- 在 phpMyAdmin 页面,点击顶部的 “新建”。
- 输入数据库名称,
dedecms_local。 - 数据库编码 选择
utf8_general_ci或utf8mb4_general_ci,这和你的织梦程序编码保持一致。 - 点击 “创建” 按钮完成数据库创建。
运行安装向导
- 现在打开你的浏览器,在地址栏输入:
http://localhost/install/(如果你的phpStudy配置了虚拟主机,则可能是你配置的域名,如http://www.dedecms.com/install/)。 - 你会看到织梦的安装欢迎页面,点击 “继续”。
- 环境检测: 系统会自动检测你的 PHP、MySQL 等环境,如果都显示“√”,说明环境没问题,如果有“×”,根据提示修改 phpStudy 的配置(通常是 PHP 版本问题)。
- 协议许可: 勾选“同意”,点击“继续”。
- 设置参数:
- 网站名称: 填写你本地测试站的名称,如“我的本地织梦站”。
- 网站首页标题: 本地测试首页”。
- 网站管理员账号:
admin(默认,可以改)。 - 网站管理员密码: 请务必设置一个强密码!
- 网站管理员邮箱: 填写一个你的邮箱。
- 数据库设置:
- 数据库服务器:
localhost(默认)。 - 数据库用户名:
root(phpStudy 默认)。 - 数据库密码:
root(phpStudy 默认,如果你修改过则填修改后的)。 - 数据库名:
dedecms_local(你刚才创建的数据库名)。 - 数据库前缀:
dede_(默认,可以不改)。
- 数据库服务器:
- 网站路径: (默认,表示在根目录)。
- CMS目录: (默认)。
- 点击 “开始安装”。
- 安装完成后,系统会提示你删除
/install/目录,回到你的WWW文件夹,手动删除这个install文件夹。
第三部分:测试织梦模板
现在织梦已经成功安装在你的本地电脑上了,你可以开始测试模板了。
使用默认模板测试
- 访问网站: 在浏览器输入
http://localhost或你配置的域名,你应该能看到织梦的默认首页。 - 进入后台: 访问
http://localhost/dede/(后台管理地址)。 - 登录: 使用你安装时设置的管理员账号和密码登录。
- 修改网站信息:
- 在后台左侧菜单,找到 “系统” -> “系统基本参数”,在这里可以修改网站名称、标题、版权信息等。
- 找到 “核心设置”,可以设置网站首页的默认文件名等。
- 发布文章测试:
- 在后台左侧菜单,找到 “核心” -> 发布” -> “添加文档”。
- 选择一个栏目(如果没有,可以去“栏目管理”里创建一个)。
- 填写文章标题、内容,选择缩略图,然后点击“确定发布”。
- 回到前台刷新页面,你应该能看到你刚刚发布的文章了,这说明模板的基本功能是正常的。
安装和使用第三方模板
这是本地测试模板最核心的环节。
-
下载模板:
(图片来源网络,侵删)- 从织梦模板官网(如织梦模板堂、模板王等)或第三方平台下载你喜欢的模板,通常是一个
.zip压缩包。
- 从织梦模板官网(如织梦模板堂、模板王等)或第三方平台下载你喜欢的模板,通常是一个
-
上传模板:
- 解压模板包,里面通常会有一个
templets文件夹。 - 登录织梦后台,在左侧菜单找到 “模板” -> “默认模板管理”。
- 在页面右上角,你会看到一个 “选择模板目录” 的下拉菜单,旁边有一个 “浏览” 按钮。
- 点击 “浏览”,选择你刚刚解压出来的模板包中的
templets文件夹。 - 选择后,点击 “确定”,后台会加载这个新模板目录下的所有模板文件。
- 解压模板包,里面通常会有一个
-
设置模板并生成:
- 加载成功后,你会看到该模板下的首页、列表页、文章页等模板文件。
- 在每个文件后面的 “设为默认” 列,点击 “是”,将它们设置为对应页面的默认模板。
- 非常重要的一步: 设置完成后,点击页面顶部的 “生成” -> “更新首页”,织梦需要根据你选择的模板重新生成静态的 HTML 文件。
- 等待生成完成,然后刷新你的网站前台,你应该就能看到新模板的样式了。
-
二次开发与调试:
- 如果你想修改模板,可以直接在后台的 “模板” -> “默认模板管理” 中点击对应模板文件后面的 “编辑” 按钮。
- 这会打开一个代码编辑器,你可以直接修改 HTML、CSS 和织梦的模板标签(如
{dede:arclist}等)。 - 修改后,同样需要去 “生成” 页面重新生成对应页面才能看到效果。
- 调试技巧: 如果页面显示异常,可以按
F12打开浏览器开发者工具,查看 Console(控制台)是否有错误信息,查看 Elements(元素)和 Network(网络)面板定位问题。
第四部分:常见问题与解决方案
-
问题:安装时提示
目录 ./data 不存在或不具备写权限!- 原因:
WWW目录下的data文件夹没有写入权限。 - 解决:
- Windows: 右键点击
data文件夹 -> “属性” -> “安全” -> “编辑” -> 给当前用户(或Users组)添加“完全控制”权限。 - phpStudy: 有些版本在
安全设置里有“开启安全模式”等选项,可以尝试关闭它。
- Windows: 右键点击
- 原因:
-
问题:网站打开一片空白,或者提示
Fatal error。- 原因: PHP 版本不兼容,织梦 V5.7 对 PHP 7.2+ 版本支持较好,但可能不完全兼容 PHP 8.0+ 的新特性。
- 解决: 在 phpStudy 中切换到一个更稳定的 PHP 版本,PHP 7.2 或 PHP 7.4,然后重启 Apache 服务。
-
问题:后台登录后跳转到空白页或登录页面。
- 原因: 通常是浏览器缓存或 Session 问题。
- 解决:
- 清除浏览器缓存和 Cookie。
- 按
Ctrl + F5强制刷新页面。 - 检查
data目录的权限。 - 尝试更换一个浏览器登录。
-
问题:安装时数据库连接失败。
- 原因: 数据库名、用户名、密码填写错误,或者 MySQL 服务未启动。
- 解决: 仔细检查安装向导中填写的数据库信息,并确认 phpStudy 中的 MySQL 状态为“运行中”。
本地测试织梦模板的完整流程就是:
搭建环境 -> 安装程序 -> 上传模板 -> 应用生成 -> 调试修改
遵循以上步骤,你就可以在本地安全、高效地进行织梦模板的学习和开发了,祝你测试顺利!
