体积预算:给首屏包设一条 170KB 的红线
首屏包 412KB 里,真正属于业务代码的只有 96KB。剩下 316KB 是三个依赖和一个图标字体。把这条线压到 168KB 之后,我把它写进了流水线,7 个月拦下 4 次超线提交。
这一期要解的问题
体积膨胀很少是一次造成的,通常是每次发布顺手加一点:这次加一个日期库,下次加一个图表,再下次把图标做成字体。三个月后回头看,首屏包翻了一倍,但没人记得是哪次提交干的。
预算的作用不是把一个数字写死,而是给“加依赖”这个动作加一道手续。这一期先把 412KB 按模块拆开,找出体积前三名,逐个替换或裁剪;再把 170KB 拆成 4 个可执行的子预算,接进流水线。
治理路径与章节
- 第 1 章 拆账:412KB 按模块倒排,业务代码 96KB,三个依赖 268KB
- 第 2 章 日期库:32KB 换成 2.1KB 的写法,处理 6 处时区差异
- 第 3 章 工具库:全量引入 71KB 改成按需,实际用到 9 个函数
- 第 4 章 图表:48KB 的整包换成按需注册,只留 3 种图
- 第 5 章 图标字体:41KB 字体换成 12 个内联 SVG,删掉 214 个没用到的字形
- 第 6 章 子预算:首屏 170KB、路由包 60KB、公共块 90KB、样式 40KB
- 第 7 章 流水线:超线即拦,附一份 4 次拦截记录与处理方式
// 第 3 章:只引入用到的 9 个函数,构建器按需摇树
export { chunk, debounce, throttle, cloneDeep, isEqual,
pick, omit, sortBy, groupBy } from './utils/index.js';
// 反例:import _ from 'lodash' 会把 71KB 全带进来
参数与交付
| 项目 | 内容 |
|---|---|
| 难度 | 中等,需会看打包分析图 |
| 章节 | 7 章,含 4 组前后体积对照与拦截记录 |
| 实测时长 | 8 小时(读 5 小时 + 改造 3 小时) |
| 验证环境 | Vite 8.0 / Chrome 142 / Lighthouse 12 |
| 前置知识 | 知道 Tree Shaking 与 gzip 的区别 |
| 配套资源 | 分析图源文件、替换对照表、预算配置文件 |
| 更新节奏 | 每季度按依赖版本复核一次 |
| 阅读授权 | 单账号,可读 24 个月 |
三个会用到它的场合
移动端弱网首屏超过 4 秒
4G 下 412KB 的首屏包要 4.6 秒才可交互。压到 168KB 后是 2.1 秒,LCP 从 3.8 秒降到 2.2 秒。这个改善不需要改业务逻辑,只换依赖写法。
多业务线共用一个壳
壳子里的依赖每加一个,所有业务线都跟着变大。第 6 章的子预算按块切,壳子的公共块单独设线,业务线加依赖时只能动自己的路由包。
要给团队定一条可执行的规矩
“注意包体积”这种话没人执行。170KB 的红线接进流水线后,超线提交直接失败,并输出超出部分的分块明细,谁加的谁处理。
和常见讲法差在哪
- 每个替换都给了前后体积与验证方式,包括时区差异这种容易被忽略的副作用。只讲“用 dayjs 替代 moment”的文章不会告诉你 6 处时区要改。
- 预算拆成 4 个子预算,不是一个总数。一个总数会让团队把预算花在不该花的块上,拆开之后每个块有自己的线。
- 给了 4 次真实拦截记录:超线多少、由谁引入、怎么处理。包括一次误拦——图标字体被拆到公共块导致的重复计算。
交付周期与阅读节奏
开通 10 分钟内可读,分析图源文件随页面下载。7 章建议分两天读,第一天 1—4 章做依赖替换,第二天 5—7 章做图标处理与流水线接入。中位耗时 8 小时,改造 3 小时左右。若你的首屏包已在 200KB 以内,只读第 6、7 章即可。
服务条款
14 天内可退。分析图与预算配置长期可下载,配置可直接放进项目。依赖版本升级导致替换方案失效时,20 个工作日内补丁,并注明新的体积数字。
选型建议
首屏包在 250KB 以内、且首屏可交互在 3 秒内的项目,先别做体积治理,收益不如把首屏图压小。真正该做的是三种:首屏包超过 350KB、弱网用户占比超过 15%、或者团队人数超过 10 人且没有评审机制。第三种不做预算,体积一定会反弹。
读完常见的问题
- 170KB 是绝对标准吗?
- 不是。这个数字来自那个项目的弱网占比与首屏结构,文中给了测算方法:按目标 LCP 反推可承受的传输量。
- 删依赖会不会增加维护成本?
- 会。文中对每个替换都算了维护成本:日期库自写 41 行、图标改 SVG 后每次新增要手动加。收益与成本都列了,自己权衡。
- 预算拦下来之后怎么处理?
- 第 7 章的做法是:先看超出块,再决定拆分、延迟加载还是拒绝。4 次拦截里有 3 次是通过延迟加载解决的,没有回退需求。