服务端直出的骨架HTML必须在开始后立即flush;浏览器无内容可解析是首屏白屏主因,需用res.write()分段输出...及骨架结构,再流式注入真实内容。

服务端直出的骨架 HTML 必须在 开始后立即 flush
首屏白屏时间长,根本不是 JS 没加载完,而是浏览器压根没东西可解析。很多项目把骨架屏塞在 index.html 里但延迟输出——比如等 SSR 数据全拿回来才吐整页 HTML,结果用户看到的是长达 800ms 的纯白屏。
真正有效的做法是:服务端一拿到路由和基础上下文,就立刻输出 <style>...</style>,紧接着 flush 骨架结构(如 <div class="skeleton-list"></div>),最后再异步流式注入真实内容。
- Node.js(Express)中用
res.write()分段输出,而非res.send()一次性返回 - Next.js / Nuxt 等框架需启用 streaming SSR(如 Next.js 13+ 的
renderToReadableStream) - 禁用
gzip或Brotli的延迟压缩(如 Nginx 的gzip_buffer过大),否则会卡住首块 flush
data-skeleton 属性必须同构且全程保留在 DOM 中
Vue/React hydration 时若发现服务端骨架节点和服务端渲染的真实节点结构不一致(比如骨架里少了 <svg></svg>,真实节点却有),就会直接销毁整个骨架容器再重建——造成“闪一下空白再出来内容”的典型抖动。
可靠写法是让骨架和真实结构完全同构,仅靠属性区分状态:
立即学习“前端免费学习笔记(深入)”;
- 骨架节点写
<button data-skeleton="true" class="btn"><span class="skeleton-text"></span></button> - 真实节点保持相同标签、子元素数量、class 名,只改
data-skeleton="false"并填充文字/图标 - 绝对不要在骨架里用
v-if、{% if %}或display: none删除节点——这会让 hydration 失去锚点
图片占位必须带宽高或 aspect-ratio,否则必然触发 CLS
只写 <img src="data:image/svg+xml,..." alt="怎么通过HTML骨架屏标签结构提升首屏性能" > 而不设尺寸,浏览器无法预留空间,图片加载完成瞬间会把下方所有内容往下顶,CLS(累积布局偏移)直接超标。
两种安全方案:
- 静态尺寸:直接写
<img style="max-width:90%" style="max-width:90%" src="data:..." alt="怎么通过HTML骨架屏标签结构提升首屏性能" >(注意是 HTML 属性,不是 CSS) - 响应式尺寸:用
aspect-ratio: 16 / 9+width: 100%;旧版 Safari 降级用padding-top: 56.25%+position: relative容器包裹 - 禁用
object-fit: cover在骨架阶段——它不改变盒模型,仍会导致重排
内联 Critical CSS 不能含 @import 或未声明的 CSS 变量
内联 <style></style> 是为了跳过 CSS 请求阻塞,但如果里面写了 @import url(...) 或引用了定义在外链 CSS 中的 --color-bg,反而会触发额外请求或样式失效,让骨架变色、错位甚至消失。
- 用
critters(Vite/webpack 插件)自动提取首屏用到的选择器,别手写 - CSS 变量必须在内联
<style></style>中重复声明,例如::root { --skeleton-bg: #f0f0f0; } - 禁用
@media查询(部分老浏览器不支持内联中的媒体查询) - 字体相关样式必须声明
font-display: block,避免文字闪动覆盖骨架



















