船说 CMS 如何更换网站模板

照着这篇做完，你就能把船说 CMS 的网站模板从旧的一套换成新的一套，并且前台正常显示、不白屏、不乱码。

换模板这件事本身只有两个动作：把模板文件放到正确目录，然后在后台选中它。真正容易出问题的是中间的准备和事后的缓存清理，下面按顺序来。

第一步：先做备份，再动手

这一步要拿到两样东西：数据库备份文件和整站文件备份。做完之后不管后面怎么折腾，都能一键还原。

登录宝塔面板（或你的服务器面板），进「网站」→ 找到船说 CMS 对应的站点 →「备份」→ 点「备份数据库」和「备份网站文件」，各点一次，确认列表里出现了新的备份记录，记下时间。

没有面板、用虚拟主机的，就用 phpMyAdmin 导出 SQL，再用 FTP 把整站拖到本地。

注意：不要跳过这一步。船说 CMS 的模板里经常带自己的数据库配置和字段调用，切换后如果前台报错，没有备份就只能重装。

第二步：确认版本和模板目录结构

这一步要搞清楚两件事：你的船说 CMS 是哪个版本、模板放在哪个文件夹。做完之后你就知道新模板该往哪放。

登录后台（默认地址一般是 你的域名/admin.php），看后台首页底部或「系统信息」里显示的版本号，常见的是 V2.x 和 V3.x。然后打开服务器文件管理，进站点根目录，找 template 文件夹——船说 CMS 的模板都放在这里，一个模板一个子文件夹，例如 template/default/、template/muban01/。

打开其中一个模板文件夹，正常应该能看到 index.html、list.html、show.html 这类模板文件，以及 static、css、images 之类的资源目录。

注意：V2.x 和 V3.x 的模板标签写法有差异，买模板或下模板时一定要问清「适配哪个版本」。拿 V2 的模板套在 V3 上，前台大概率是一堆空白。

第三步：把新模板上传到 template 目录

这一步把新模板文件放到服务器上，做完之后后台的模板列表里就能看到它。

在文件管理里进入 template/，点「上传」，把新模板的压缩包传上去，然后右键压缩包选「解压」。解压后确认目录层级是 template/新模板名/index.html，而不是 template/新模板名/新模板名/index.html——多套一层是最常见的错误。

如果模板自带安装说明要求覆盖 static 或 public 目录，按说明做，但先把被覆盖的目录改名为 static_bak 保留。

注意：上传前把压缩包在本地解开看一眼，很多模板包里还夹着 __MACOSX、.DS_Store 这类垃圾文件夹，删掉再传，免得后台模板列表里多出一堆没用的项。

第四步：在后台切换到新模板

这一步是真正的「换模板」动作，做完之后前台就开始用新模板渲染了。

进入后台，找「系统」→「模板管理」（部分版本叫「网站设置」→「模板选择」，或「外观」→「模板切换」）。页面里会列出 template 目录下所有模板文件夹，每个后面有「启用」或单选按钮。选中刚上传的新模板，点页面底部的「保存」或「确定」。

保存成功后，后台顶部一般会弹一条绿色提示。有些版本还会在这里附带「PC 模板」「手机模板」两个下拉框，如果新模板只做了 PC 端，手机端那一栏就保持原来的默认模板，别一起换掉。

注意：切换前先确认新模板文件夹名不含中文和空格，含中文的目录名在某些服务器上会导致模板加载失败。

第五步：清缓存并刷新前台

这一步让新模板真正生效，做完之后前台显示的就是新界面。

后台找「系统」→「系统工具」→「清除缓存」（有的版本叫「更新缓存」），点一次。然后回到服务器文件管理，进站点根目录，看看有没有 runtime 文件夹，有的话进去把 cache 和 temp 两个子目录里的内容删掉（目录本身保留）。

最后打开浏览器，按 Ctrl+F5 强制刷新前台首页。

注意：只清后台缓存不清 runtime，经常出现「后台显示已切换、前台还是旧样子」的情况，八成就是这里没做。

第六步：检查页面并处理常见问题

这一步确认换完没问题，做完之后你就可以正式用了。

依次打开首页、栏目列表页、内容详情页、搜索页四个页面，重点看：导航和图片是否正常、中文有没有变乱码、原来的链接还能不能打开。

• 页面全白或报 Fatal error：模板版本不匹配，回第四步换回原模板，或联系模板作者要对应版本。
• 图片不显示：新模板的图片路径写死了旧域名，用编辑器在模板文件里批量替换成你的域名。
• 样式全乱：static 目录没上传或没覆盖。
• 中文乱码：模板文件编码不是 UTF-8，用编辑器另存为 UTF-8 无 BOM。

确认无误后，把第一步的备份再导出一份到本地存着。

小结

• 换模板 = 放文件到 template/ + 后台「模板管理」里选中保存，就这两步。
• 动手前必须备份数据库和整站文件，这是唯一的安全网。
• 上传后确认目录层级是 template/模板名/index.html，不要多套一层。
• 切换后要清后台缓存 并 删 runtime/cache、runtime/temp，再 Ctrl+F5 刷新。
• 模板版本（V2.x / V3.x）和 CMS 版本必须对得上，否则白屏。
• 手机模板和 PC 模板分开设置，别一起换。