IOUXI 首页 › 博客 › 小包体策略:首屏 ≤300KB 的资源管线

小包体策略:首屏 ≤300KB 的资源管线

发布于 2026-11-17 · 更新于 2026-11-17 · 13 分钟阅读 · IOUXI 编辑部

一个 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 后压缩比
首页 HTML110,673 B32,686 B70.5%
文章页 HTML30,263 B10,698 B64.6%
/assets/iouxi.css22,664 B5,154 B77.3%
/assets/iouxi-content.css1,956 B856 B56.2%
/assets/schizoflip-radar.js11,320 B4,266 B62.3%
/assets/icon.svg—361 B—

也就是说,一篇文章页的首屏(HTML + 两份 CSS + 图标)gzip 后约 17.1KB,距离 300KB 预算还剩 94% 的余量。真正吃预算的从来不是文档页,而是游戏本体。

三、JS 是预算的主要占用方:分割、摇树、按需加载

web.dev 的代码分割文档把逻辑讲得很直白:JavaScript 载荷如果加载时间超过 3 秒,会显著拖慢站点;拆包的目的就是在启动阶段只发首屏真正需要的代码,从而减少主线程的解析、编译与执行成本,直接改善 INP;如果站点重度依赖客户端渲染,还会连带影响 LCP。

三个可落地的手段:

  1. 动态 import 按需加载。文档给的示例用 import('library.moduleA') 把只在表单提交时才用到的模块从首包中剥离,改成懒加载。
  2. vendor 分包 + 长缓存。第三方依赖单独拆出来单独缓存,因为它们更新频率低。
  3. 摇树与库瘦身。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 排序打印出来,哪一个文件超预算一目了然。

把上面这些串起来,本文的资源管线顺序是:先定 300KB/170KB 的预算线 → 用 gzip/br 压文本 → 用动态 import + 摇树砍 JS → 图片出 3–5 档 srcset、首屏外 lazy-load → 字体按需下载并 preload → 静态资源改哈希文件名 + immutable → 用 Resource Timing + Lighthouse 每次发布自动核对。

常见问题

首屏 300KB 到底包含什么?超了先砍哪个?
通常指首屏关键路径上传输的 HTML + CSS + 首屏 JS + 首屏图片的传输体积总和,gzip/br 压缩后的字节数才是可比口径。超预算时的砍单顺序是:先查未压缩的文本资源有没有开 gzip/br,再查 JS 里有没有整包引入的第三方库(改按需 import),再查图片是否直接上了原图(改 3–5 档 srcset),最后才考虑砍功能。
300KB 的预算是压缩前还是压缩后?为什么?
按压缩后算。web.dev 的性能预算文档明确写的是「关键路径资源(压缩/最小化后)小于 170KB」,Lighthouse 的 LightWallet 示例里 resourceSizes 的 total 预算 300、script 预算 125 也是按传输体积判定的。用原始体积卡预算会严重高估用户的实际下载成本。
用 Lighthouse 就能自动拦住超预算的版本吗?
可以。Lighthouse v5+ 命令行版本支持 LightWallet,把 budget.json 用 --budget-path 参数传入后,报告的 Performance 分类下会多出 Budgets 一节,JSON 报告里对应 performance-budget 这条审计的 findings。把它挂进 CI,超预算就让构建失败,这才算把预算变成闸门而不是文档。
静态资源要不要给很长的缓存时间?哈希文件名有什么用?
要,但前提是文件名带内容哈希。文件名一变就是新 URL,浏览器自然重新下载,所以可以安全地用 Cache-Control: public, max-age=31536000, immutable 之类的长缓存;没有哈希的文件名只能给短缓存并配合 must-revalidate。本站自研弹珠跳棋的 main-Dhi79gN1.js 就是哈希命名 + immutable 的做法,而内容页的资源目前仍是 max-age=2592000,这一层还有优化空间。

文中提到的游戏

相关阅读

Canvas 2D 性能札记:rAF、离屏渲染与脏矩形网页小游戏 Canvas 2D 性能优化实操:用 requestAnimationFrame 驱动主循环、离屏画布预渲染、分层画布与脏矩形重绘,把掉帧的弹球游戏拉回 60fps。把「跳一下」做爽的 8 个参数:加速度 / 土狼时间 / 输入缓冲网页小游戏跳跃手感的 8 个可调参数:起跳速度与重力、水平加速度、土狼时间、输入缓冲、可变跳高、命中停顿、60Hz 固定步长、输入轮询,每项都给出可验证的数值与出处。从 0 到上线:独立开发者最小可用流程与时间预算独立网页小游戏从 0 到上线的最小可用流程:四个阶段、12–15 个工作日预算,含 LCP 2.5 秒、PWA 192/512 图标、localStorage 10 MiB 等硬阈值。手机玩网页小游戏:横屏、触屏、性能与省流指南手机玩网页小游戏实战指南:viewport 横屏全屏、Pointer Events 触屏、dvh 与安全区、deviceMemory 低配降级、Save-Data 省流,附 Core Web Vitals 指标与可运行代码。Web 小游戏引擎与工具链选型清单(含对比表)做 HTML5 小游戏该选哪个引擎?这份清单用对比表横向比较 Canvas 原生、Phaser、PixiJS、Three.js、Excalibur.js、Kaboom.js 六个方案的上手门槛、体量、3D 能力与适用场景,并给出从零做第一款游戏的工具链顺序与素材、教程、部署的完整清单。低配手机 / 省流 / 弱网也能玩的小游戏清单手机内存小、流量有限、网速不稳时该玩什么?这份清单按「单指触屏可玩 / 双人同屏必须键盘 / 需要稳定联网」三类拆开,列出 14 款站内真实收录的网页小游戏,说明各自的触屏友好度、是否外链直开,以及省流与弱网下需要注意什么。

事实来源

返回栏目首页 · 博客