船说 CMS 图片懒加载怎么开启

学完这篇，你能在船说 CMS 后台开启图片懒加载，或者在内置开关缺失时用模板法手动加上，并验证前台是否生效。

第一步：确认版本和后台入口

这一步要确认你的船说 CMS 有没有内置懒加载开关，做完能决定用后台开还是改模板。浏览器打开 https://你的域名/admin.php（船说 CMS v2.0.3 默认后台入口是 /admin.php；如果你安装时改过后台目录，用改后的地址）。登录后看右上角或「系统信息」里的版本号。v1.8.0 以上一般有「性能优化」；低于这个版本，直接跳到第四步。

第二步：在后台开启图片懒加载

这一步是在有内置开关时一键开启，做完系统会自动处理内容区图片。依次点左侧菜单「系统」→「系统设置」→ 顶部「性能优化」标签页。找到「图片懒加载」，把下拉框从「关闭」改成「开启」；加载方式选「滚动加载」；占位图填 /static/images/loading.gif（没有这个图就上传一张 1x1 的 gif 到该目录）。点页面底部「保存」。

注意：如果「性能优化」里只有「HTML 压缩」「缓存时间」，没有「图片懒加载」，说明这个版本不带该功能，不要反复找，直接走第四步模板法。

第三步：更新缓存并刷新前台

这一步让改动立即生效。点左侧「系统」→「更新缓存」，勾选「模板缓存」「数据缓存」，点「开始更新」。然后打开前台首页，按 Ctrl+F5 强制刷新。结果：内容里的 <img> 会被输出成带 loading="lazy" 或 data-original 的形式。

第四步：模板法（后台没有开关时）

这一步手动给模板加懒加载，做完列表页、详情页图片都会滚动到附近才加载。用 FTP 或主机文件管理器进入网站根目录，打开 /template/你的模板目录/，找到 header.html 或 common/header.html。在 </head> 前加一行：

<script src="/static/js/lazysizes.min.js" async></script>

把 lazysizes.min.js 上传到 /static/js/。然后改图片标签：把 <img src="{$vo.thumb}" 改成 <img class="lazyload" src="/static/images/loading.gif" data-src="{$vo.thumb}"。如果你的模板变量是 {$v.thumb} 或 {$item.pic}，按实际变量替换。

注意：不要只改首页。列表页、详情页、搜索页模板都要改，否则会出现有的图懒加载、有的不加载。

第五步：验证是否生效

这一步确认懒加载真的工作。前台打开文章列表，按 F12 打开开发者工具，切到「Network」→「Img」，刷新页面。如果滚动到图片附近才出现图片请求，说明成功。如果图片空白，检查 data-src 地址是否完整、lazysizes.min.js 路径是否 404。

小结：

• 先看船说 CMS 版本和「系统」→「系统设置」→「性能优化」里有没有「图片懒加载」。
• 有开关就开启，然后「系统」→「更新缓存」。
• 没开关就改模板：引入 lazysizes，把 src 换成 data-src 并加 class="lazyload"。
• 所有含图的模板都要改，不能只改首页。
• 用 F12 的 Network/Img 验证，滚动后才请求图片即为成功。