一个 Web 小游戏的首屏预算可以定死:HTML + CSS + 首屏 JS gzip 后 ≤300KB,关键路径资源 ≤170KB,这两条数字是 web.dev 给出的默认基线,也是本节所有管线的验收线。
一、先定预算:数字必须写在纸上,而不是靠感觉
web.dev 的《Performance budgets 101》把性能预算定义为「对影响站点性能的指标设定的一组上限」,可以约束整页体积、移动网络加载时间,甚至 HTTP 请求数量。文档给出了一组可以直接抄的默认基线:Time to Interactive 小于 5 秒、关键路径资源(已压缩/已最小化)小于 170KB,并明确说明这两个数字是按真实基线设备与 3G 网络速度算出来的。
预算要分两类同时看:数量型指标(图片最大体积、脚本总体积、字体数量、第三方资源总数)和里程碑指标(FCP、TTI、LCP)。文档提醒了一个容易被忽略的坑:请求数和体积相同的两个页面,渲染速度可以差很多——如果关键样式表或主视觉图被排到后面请求,用户就要多等。所以纯看「总大小」的预算必须配合时间指标一起卡。
预算怎么定出来?《Your first performance budget》给的是竞品对比法:先选 10 个左右同类站点,量它们的 FCP 和 TTI,再套用 20% 法则——用户对超过 20% 的响应差异是有感知的,所以要做出可感知的领先,就得比最快的竞品还快 20%。文档里的示例是 Doggos.com:FCP 1800ms、TTI 6500ms,按 20% 法则先定 1440ms / 5200ms 的短期预算,长期目标压到 704ms / 2520ms。
预算要能被机器执行才有意义。《Use Lighthouse for performance budgets》给出了工具方案:Lighthouse v5+ 命令行版本支持 LightWallet,写一个 budget.json,用 --budget-path 参数传入:
[{
"path": "/*",
"timings": [{ "metric": "interactive", "budget": 3000 }],
"resourceSizes": [
{ "resourceType": "script", "budget": 125 },
{ "resourceType": "total", "budget": 300 }
],
"resourceCounts": [{ "resourceType": "third-party", "budget": 10 }]
}]
这份示例本身就定义了「首屏 ≤300KB」的含义:整页 300KB、脚本 125KB、第三方请求 10 个。该文最后更新于 2019-06-14,是本篇引用中唯一一篇带明确日期的官方文档。
二、压缩与最小化:文本资源的免费午餐
web.dev 的编码优化文档给出了两层处理:压缩(传输层,用 gzip/br/deflate 把字节流变小)与最小化(构建层,删掉源码里对功能无用的空白、注释、冗余声明)。文档用一个教学例子演示压缩效果:把 AAA 编码成 3A 这样的游程形式后,整个示例消息从原始长度压缩掉 72%。文档同时强调,压缩算法实际远比这个例子精密,而且「最小化」严格说不是压缩算法,而是一种内容相关的优化,最好在构建与部署环节自动完成。
具体到 HTTP 层,MDN 的 Content-Encoding 文档列出了官方认可的编码标识:gzip、compress(因专利已过期、浏览器基本不用)、deflate、br(Brotli)、zstd(Zstandard)、以及 dcb/dcz。该特性标注为 2015 年 7 月起在各浏览器广泛可用。服务器侧的协商靠 Accept-Encoding 请求头完成。
压缩率有多可观?拿本站真实产物实测(2026-11-17,curl 直连 https://iouxi.com):
| 资源 | 原始体积 | gzip 后 | 压缩比 |
|---|---|---|---|
| 首页 HTML | 110,673 B | 32,686 B | 70.5% |
| 文章页 HTML | 30,263 B | 10,698 B | 64.6% |
/assets/iouxi.css | 22,664 B | 5,154 B | 77.3% |
/assets/iouxi-content.css | 1,956 B | 856 B | 56.2% |
/assets/schizoflip-radar.js | 11,320 B | 4,266 B | 62.3% |
/assets/icon.svg | — | 361 B | — |
也就是说,一篇文章页的首屏(HTML + 两份 CSS + 图标)gzip 后约 17.1KB,距离 300KB 预算还剩 94% 的余量。真正吃预算的从来不是文档页,而是游戏本体。
三、JS 是预算的主要占用方:分割、摇树、按需加载
web.dev 的代码分割文档把逻辑讲得很直白:JavaScript 载荷如果加载时间超过 3 秒,会显著拖慢站点;拆包的目的就是在启动阶段只发首屏真正需要的代码,从而减少主线程的解析、编译与执行成本,直接改善 INP;如果站点重度依赖客户端渲染,还会连带影响 LCP。
三个可落地的手段:
- 动态 import 按需加载。文档给的示例用
import('library.moduleA')把只在表单提交时才用到的模块从首包中剥离,改成懒加载。 - vendor 分包 + 长缓存。第三方依赖单独拆出来单独缓存,因为它们更新频率低。
- 摇树与库瘦身。web.dev 的《Remove unused code》建议用 webpack Bundle Analyzer 的 treemap 视图定位包体构成,把
import firebase from 'firebase'改成只引需要的子路径(如firebase/app、firebase/database);如果某个库根本没法拆分,就考虑整体移除或换更轻的替代方案。
本站自研的弹珠跳棋(Marble Checkers,线上地址 https://chinesecheckers.iouxi.com/ )就是一个可核对的正反例:实测首页 HTML 原始 3,529 B / gzip 1,494 B,主 JS main-Dhi79gN1.js 原始 643,639 B、gzip 后 173,123 B(约 169KB),CSS main-BGTd-Uhj.css 原始 21,855 B / gzip 5,305 B。也就是说单个 JS 文件 gzip 后就吃掉了 300KB 预算的 56%,而它还是基于 Three.js 这类 3D 引擎的产物——首屏就能开一局的轻量 2D 游戏没有理由超过这个量级。它的静态资源用的是带内容哈希的文件名加 cache-control: public, immutable,这正是 MDN Cache-Control 文档里 immutable 指令的用法:配合哈希文件名,资源可以永久缓存而不必担心更新。
四、静态资源管线:图片、字体与缓存头
图片。web.dev 的响应式图片文档建议一张图生成 3–5 个尺寸版本,用 srcset 声明宽度描述符(如 480w、1080w)、用 sizes 告诉浏览器实际占位宽度,浏览器自己挑;src 只作为不支持 srcset 的老浏览器的兜底,并且要给足尺寸。文档还指出响应式图片能减少带宽争抢,从而整体改善加载速度。首屏之外的图片用 loading="lazy" 推迟加载——MDN 的 HTMLImageElement.loading 文档确认该属性取值 eager 或 lazy,并给出了动态创建图片时设置 loading = "lazy" 的示例。
字体。web.dev 字体最佳实践指出,字体加载策略要和样式表同等对待,因为样式表的改法与投递方式变化对字体影响显著;文档给出的做法是让字体只在页面真的用到时(比如含 <h1>)才下载,并推荐配合 preload 资源提示与 Font Loading API 使用。MDN 的 <link> 文档给出了 preload 的标准写法,且明确 as 属性在 rel="preload" 时是必填的:
<link rel="preload" href="myFont.woff2" as="font" type="font/woff2" crossorigin="anonymous">
缓存头。MDN Cache-Control 文档说明 max-age=N 表示响应在生成后 N 秒内保持新鲜,immutable 用于内容不会变的资源,must-revalidate 则要求缓存离线时也必须回源校验。本站静态资源当前用的是 max-age=2592000(30 天)加 public,若改成内容哈希文件名,就该进一步切到 immutable——这一点本站的内容页目前仍可优化。
关键资源的优先级。web.dev 的 LCP 优化指南指出 LCP 应争取在 2.5 秒以内(至少 75% 的访问),并强调「TTFB 与 FCP 的差值很大」往往意味着浏览器要下载大量阻塞渲染的资源。配合 preload 提前拉取 LCP 图、用 preconnect 提前建连,是把 300KB 预算花在刀刃上的方式。
五、怎么验收:用 Resource Timing 自查,而不是靠感觉
预算定完必须可观测。MDN 的 PerformanceResourceTiming 接口正是干这个的:它标注为 2017 年 9 月起广泛可用,可以拿到每个资源的详细网络时序。其中三个字段是做包体核算的关键:
transferSize:实际传输字节数(含响应头折算值),这是「用户真正下载了多少」;encodedBodySize:应用了内容编码之前的载荷体积;decodedBodySize:去掉内容编码之后的体积。
三者的差值就是压缩收益。一段十行的浏览器控制台脚本就能把全页资源按 transferSize 排序打印出来,哪一个文件超预算一目了然。
把上面这些串起来,本文的资源管线顺序是:先定 300KB/170KB 的预算线 → 用 gzip/br 压文本 → 用动态 import + 摇树砍 JS → 图片出 3–5 档 srcset、首屏外 lazy-load → 字体按需下载并 preload → 静态资源改哈希文件名 + immutable → 用 Resource Timing + Lighthouse 每次发布自动核对。