ZBlogCMS 如何更换网站模板主题

照着这篇做完，你就能给 ZBlogPHP 站点换上一套新模板，并且知道换完之后该点哪里、哪里容易出问题。下面以 Z-BlogPHP 1.7 版本的后台为例，从备份一路讲到出问题怎么回滚。

第一步：先备份，再动手

这一步要拿到一份「能退回原样」的保险，做完之后再折腾主题就不慌了。

需要备份三样东西：

1. 数据库：用宝塔面板的「数据库 → 备份」，或 phpMyAdmin 导出 .sql 文件。
2. 主题目录：把 zb_users/theme/ 整个文件夹下载到本地。
3. 当前启用的主题名字：后台左侧菜单「主题」里，卡片上带「正在使用」标记的那个，记下它的文件夹名。

注意：数据库备份不要只留在服务器同一个目录里，主题装崩了连后台都进不去时，你需要的是一份能在本地打开的文件。

第二步：把新主题放进站点

这一步要把主题文件下载到服务器上，做完之后后台主题列表里会出现新主题的卡片。三种方式选一种即可。

方式一：应用中心在线安装（最省事）

登录后台 → 左侧菜单「应用中心」→ 页面顶部切到「主题」标签 → 在搜索框输入主题名 → 点击该主题卡片上的「获取」或「安装」。安装完成后主题会自动出现在「主题」列表里。

方式二：上传本地 zip 包（第三方主题常用）

后台左侧菜单「主题」→ 页面右上角「上传主题」按钮 → 选择你下载的 zip 压缩包 → 点「提交」。上传成功后系统会自动解压。

方式三：FTP／宝塔文件管理器手动上传

把 zip 在本地解压，得到形如 mytheme 的主题文件夹，整个上传到 zb_users/theme/ 目录下。最终路径必须是 zb_users/theme/mytheme/theme.xml，也就是说 theme.xml 要直接在主题文件夹里。

注意：压缩包解压后多套一层目录（变成 zb_users/theme/mytheme/mytheme/）是最常见的失败原因，后台会看不到主题。另外主题文件夹名别用中文、空格和特殊符号，compile 目录要有写入权限（宝塔里权限设为 755、所有者 www）。

第三步：启用主题

这一步让新外观真正生效，做完后刷新前台就能看到新样式。

后台左侧菜单「主题」→ 找到新主题的卡片 → 点击卡片上的「启用」按钮。状态会变成「正在使用」，此时网站前台已经换上了这套模板。

第四步：配置主题自己的选项

这一步把主题的 Logo、配色、侧栏等设置调成你要的样子。

在「主题」列表里，切换到新主题后看卡片上有没有「设置」按钮：有就点进去，逐项填 Logo 地址、首页样式、侧栏开关等。没有「设置」按钮的主题，通常靠配套插件配置，回到「应用中心 → 插件」看看有没有对应的扩展；也可能需要改主题目录里的模板文件。

注意：付费主题一般绑定了域名授权，换域名或换主题后可能提示未授权，先看清楚主题自带的使用说明再联系作者。

第五步：清空缓存并重建

这一步让新模板的编译文件重新生成，做完后页面显示才算真正正常。

点击后台菜单里的「清空缓存并重建」（1.7 版在后台右侧顶部导航，老版本在「网站设置」下）。执行完之后，前台按 Ctrl + F5 强刷一次。

注意：只换主题不清缓存，很容易出现新旧样式混在一起、侧栏错位、页面报错的情况。换了主题、改了模板文件，都要做这一步。

第六步：检查全站并准备回滚

这一步确认换主题没有把网站弄坏。

挨个打开首页、分类页、文章页、单页、搜索结果页和手机端，看排版有没有错位、图片有没有丢。如果出现整站白屏或进不去后台：用 FTP 把 zb_users/theme/新主题名 目录改名或删掉，Z-BlogPHP 找不到主题会自动回落到默认主题，再进后台把旧主题启用回来、清一次缓存就行。

小结

• 动手前备份数据库和 zb_users/theme/，并记下当前主题文件夹名。
• 主题有三种安装方式：应用中心「获取」、后台「上传主题」、FTP 放到 zb_users/theme/，theme.xml 必须直接在主题目录里。
• 在「主题」列表点「启用」生效，点「设置」配置主题选项。
• 换主题后一定要「清空缓存并重建」，再 Ctrl + F5 刷新前台。
• 出问题就把新主题目录改名或删除，自动回落默认主题后启用旧主题。
• 1.7 主题不能用在 1.6 上，下载前先确认兼容的 Z-BlogPHP 版本。