正确安装步骤
- 下载模板包，本地解压，确认目录结构。
- 整个模板文件夹上传到
/template/目录下。 - 后台 → 模板管理，选择刚上传的模板并保存。
- 刷新前台看效果。
坑 1：上传了压缩包但后台不显示
最常见的原因是解压后多了一层文件夹。正确路径应该是 template/模板名/index.html，如果变成 template/模板名/模板名/index.html 就识别不到。
解决：去掉多余的一层，重新放到正确位置，权限 755。
坑 2：版本不兼容，启用后直接白屏 / 500
V10 有多个小版本（10.0 / 10.1 / 10.2），部分第三方模板只适配了其中某一个。
- 下载前看清标注：「支持 V10 全版本」还是「V10.0 专用」。
- V9 的模板硬装到 V10 一定报错，别试。
- 排查：打开
/application/extra/config.php把debug改成true，刷新前台会直接显示出错的模板文件和行号，能省掉 80% 的瞎猜时间。
坑 3：免费模板夹带后门
某些「免费」模板会在 index.html 或 header.php 里插入一段 JS，让网站跳转到赌博或色情站。
排查办法：装完后用浏览器「查看源代码」，搜索有没有来路不明的 <script src="http...。价格低得离谱（5 元以下）的模板要格外警惕。
坑 4：模板报错「模板文件不存在」
三个名字必须严格对应：模板目录名、模板文件名、后台配置里选的模板名。比如后台选的是 cms_grass，但 /template/cms_grass/ 下没有 index.html，前台就直接白屏。