#结论
CLS 不是 0 的时候,第一反应都是去查图片有没有写宽高。我的图片早就补齐了 width / height,布局偏移还是有 0.0176。
偏移来自三个空位:导航里的登录格、栏目条、标签条。它们的共同点是HTML 到手时是空的,内容要等 JS 拉完接口才填。填进去的那一刻,下面所有东西重新排一遍。
| 位置 | 桌面 1440 | 移动 390 |
|---|---|---|
登录格 #nav-user | 整条导航左移 55px | 导航多折一行,+53px |
| 栏目条 + 标签条 | 列表下推 40px | 列表下推 182px |
三处改成服务端直出后,移动端 4× CPU 降速下的 CLS 是 0。
一句话记住:首屏元素的高度和宽度,在 HTML 里就该是最终值。 让 JS 去补,等于每次访问都先演一遍错版,再当着读者的面纠正。
#一、先分清哪些偏移是图片的
layout-shift 是 PerformanceObserver 里最不被重视的一个。它给的不是一个分数,而是每一次偏移的明细:变了多少、影响了哪几个元素。
new PerformanceObserver((list) => {
for (const e of list.getEntries()) {
if (e.hadRecentInput) continue; // 用户自己点出来的不算
// e.sources 里每一项就是被推走的那个元素
for (const s of e.sources) {
console.log(e.value.toFixed(4), s.node?.className || s.node?.tagName, s.previousRect, s.currentRect);
}
}
}).observe({ type: 'layout-shift', buffered: true });改之前跑一遍,sources 里点名的不是 img,是 #catbar、#tagbar、#nav-user 这三个。分数小是因为被推的是列表容器,面积大、位移小;移动端那 182px 就没有这么客气了。
顺带排除了两个常见嫌疑:图片全都有宽高,font-display 也没问题(整站用系统字栈,-apple-system 那一套,没有 web font 交换)。
#二、51px 那一格
#nav-user 在 HTML 里原来是个空 <span>。app.js 拿到 /api/me 之后才知道该填「登录」还是「后台」,中间隔着一次网络往返。
填进去的瞬间,nav 多出一个有宽度的子项,整条导航往左让位:
| 视口 | nav 宽度 | 位移 |
|---|---|---|
| 1440×900 | 415px → 360px | 左移 55px |
| 390×844 | 高 366px → 419px | 多折一行,+53px |
55px 是「登录」那个链接的 51px 加上 nav 的 gap: 4px。窄屏更难看:nav 本来就在折行,多这一项正好越过一行的边界,整条导航从两行变三行,首屏内容整体下移 53px。
修法是别等:
/* 匿名访客先填上真实的「登录」链接,不是占位符 */
`<span id="nav-user"><a href="/login">登录</a></span>`/* span 不参与 flex 布局,里面的 <a> 才是 nav 的那个 item */
#nav-user { display: contents; }
/* 万一真的空了,也别留一个空盒子在那占位 */
#nav-user:empty { display: none; }display: contents 那条不是装饰。少了它,<span> 自己变成一个 flex item,宽度塌成 0、gap 也套两层,填进去之后间距全错。
#三、为什么不用固定宽度的骨架块
width: 51px 那种占位块看起来更"正统",但它不是。
51 是测量值,不是常量。字号缩放、换成英文、文案改成一个字,宽度都会变。骨架块能盖住第一次偏移,等真实内容进来再跳一次——等于把一次错的尺寸换成另一次错的尺寸。
服务端直接输出真实内容,宽度是浏览器算出来的,天然准。这不需要额外查询:这个链接本来就是静态的,/login 永远存在。
还有个副作用是好的:JS 挂了或者被拦了,导航仍然完整。骨架块在 JS 失效时就是一块空白。
#四、两个筛选条:40px 和 182px
#catbar(栏目)和 #tagbar(标签云)是同一个病:两个空 div,等 app.js 拉完 /api/categories 才 innerHTML。
把这两块清空再量列表位置,差值是实际被推走的距离:
| 视口 | 列表被下推 |
|---|---|
| 1440 | 40px |
| 390 | 182px |
移动端 182px 已经超过屏高的五分之一——这是读者打开页面后第一眼看到的东西在跳。
这两块的数据本来就在并行取(栏目计数、标签云和文章列表是三个独立的查询),在模板渲染阶段直接输出,零额外查询:
// 三个 Promise 一起发,谁也不等谁
const [list, counts, tags] = await Promise.all([listP, catCounts(env), tagsData(env.DB)]);
body = renderCats(body, counts, tags); // 服务端就把 HTML 写好客户端那边只剩一件事:把当前栏目/标签标成选中态。不再建 DOM,也不会撑高容器。
#五、已登录的访客为什么不 SSR
不能。HTML 是全站共享边缘缓存的,把用户名塞进去会串号——A 打开页面拿到 B 的登录态。
所以只有匿名态进 HTML,app.js 到了再替换同一个 item 的内容。替换不新增 flex item,位移从「整条导航重排」降到几个像素,而且发生在页面已经可交互之后。
这里有个取舍要说清:登录态的宽度确实和匿名态不完全一样(「登录」51px,登录后是后台入口那一组)。但这条位移只在已登录访客身上发生一次,量级是几个像素,不会让读者觉得页面在动。
#六、改完的数字
移动端用 4G 模拟(1.6Mbps / 150ms RTT)+ 4× CPU 降速,桌面 1440×900:
| 指标 | 桌面 | 移动 |
|---|---|---|
| LCP | 224 ms | 760 ms |
| CLS | 0 | 0 |
| INP | 32 ms | 16 ms |
| TTFB | 51 ms | 152 ms |
CLS 从 0.0176 到 0 只改了渲染位置,没有动资源。LCP 和 INP 是同一批改动里的附带结果:首屏不再等接口,图片变成 <picture> 协商格式。
#七、边界
- 骨架块不是不能用,它适合「真实内容要慢查询才拿得到」的场景。但骨架的尺寸必须等于最终尺寸,否则只是把偏移从一次变成两次。这个站的三个位置都是数据已经在手上,所以直接输出更好。
- 正文图片仍然是最常见的偏移源。这三处改完不代表 CLS 一定归零,
width/height少一个就前功尽弃。我这边的图是从上传时就量好尺寸拼进 URL 的,渲染时写成属性再把参数剥掉。 - 登录态替换仍然有位移。想彻底消掉就得给两种状态同一个宽度,代价是一个很宽的登录按钮或者一个很窄的后台入口,不值得。
hadRecentInput要跳过。用户点了按钮导致的下拉展开不算 CLS,不跳过的会把自己吓一跳。
#一条清单
下次查 CLS,按这个顺序:
- 先抓
layout-shift的sources,看被推的到底是哪个元素。别猜。 - 该元素的 HTML 到手时是不是空的?空的就是病根。
- 数据是否已经在并行查询里?在,就挪到服务端输出。
- 只有拿到数据必须等一次往返、且快不起来的时候,才用骨架块,并且让骨架尺寸等于最终尺寸。
- 改完分别量窄屏和宽屏。同一个空位在宽屏是横向 55px,在窄屏是折行多出 53px——两个数不是一回事。





