现象
移动端 CLS 长期 0.25,列表页图片加载完成后整页往下推,广告位插入时正文再跳一次,用户经常点错链接。桌面端只有 0.04,问题集中在手机。
原因
三处偏移叠加:img 只写了 CSS 宽度没写高度,加载前高度为 0;广告位由脚本注入,外层容器没设最小高度;自定义字体替换系统字体后行高变化。移动端视口窄,同样像素的位移占比更大,分数被放大。异步插入的公告条又把上方内容整体推开一次。还有一处容易忽略:图片容器写了固定高度但没写宽度,换行后比例不一致,同样会跳。
解决步骤
第一步,找出真正在跳的元素。用 Layout Instability API 记录每次偏移的分值和来源节点,排除用户点击引起的抖动。
new PerformanceObserver((list) => {
for (const e of list.getEntries()) {
if (e.hadRecentInput) continue;
console.log(e.value.toFixed(3), e.sources.map(s => s.node));
}
}).observe({type: "layout-shift", buffered: true});
第二步,给图片定死比例。img 补上 width、height 两个属性和 aspect-ratio,CSS 里写 height: auto,让浏览器在图片下载前就按比例占好位置。
第三步,给动态内容留位。广告容器和顶部公告条设固定 min-height,脚本加载完只替换内部节点;字体只 preload 首屏用到的一个字重,其余用 font-display: swap 兜底。
验证
连续测三天,CLS 从 0.25 降到 0.06,图片加载和广告插入都不再引起整页位移,只有用户主动点击产生的偏移被正确排除。
小结
CLS 不是玄学,就是没占位。先抓到偏移节点,再给图片比例、给容器高度、给字体兜底,三条补齐分数自然下来。
