构建提速:冷启动从 41 秒到 6 秒的五次改造
2026 年 1 月,一个 2400 个依赖的前端仓库冷启动要 41 秒,改一行代码等 6 秒才看到效果。5 次改造之后冷启动 6 秒,热更新 0.4 秒,缓存命中率 87%。
这一期要解的问题
构建慢的账要拆开算。41 秒里有 18 秒花在依赖预构建,9 秒在解析 1.1 万个模块,7 秒在插件链上的 14 个转换,剩下 7 秒是文件读写与哈希计算。不算清这四笔账,任何优化都只是猜。
五次改造的顺序是按收益排的,不是按难度排:先关掉不必要的插件,再缩依赖预构建范围,再上增量缓存,再拆插件链,最后才是换构建器。换构建器放最后,因为它会牵动所有前面的配置,收益却常常不如前四步。
五次改造与耗时记录
- 第 1 次 关掉 6 个只在打包时用得上的插件:开发态 41 秒降到 33 秒
- 第 2 次 依赖预构建白名单:从 2400 个降到 380 个,33 秒降到 22 秒
- 第 3 次 增量缓存:模块解析结果落盘,二次启动 22 秒降到 9 秒
- 第 4 次 拆插件链:14 个转换按文件类型分组,只跑命中的,9 秒降到 6.4 秒
- 第 5 次 换构建内核:最后 0.4 秒,同时把产物构建从 74 秒降到 31 秒
// 第 2 次:依赖预构建不要全量扫,只列真正在源码里 import 过的包
export default {
optimizeDeps: {
include: ['vue', 'pinia', 'dayjs', 'echarts/core'],
exclude: ['@company/legacy-ui', 'lodash-es'],
},
};
参数与交付
| 项目 | 内容 |
|---|---|
| 难度 | 中高,需要能读构建日志 |
| 章节 | 7 章,5 次改造各一章,另加测量与回滚两章 |
| 实测时长 | 12 小时(含 5 次在自己项目里的复测) |
| 验证环境 | Vite 8.0 / Node 26.1 / macOS 15 与 Windows 11 各一台 |
| 前置知识 | 用过 Vite 或 Webpack,知道插件在哪个阶段执行 |
| 配套资源 | 5 份配置 diff、耗时采样脚本、回滚清单 |
| 更新节奏 | 每季度同步构建器版本差异 |
| 阅读授权 | 单账号,可读 24 个月 |
三个会用到它的场合
团队抱怨“改一行等半天”
最常见的是插件链臃肿。第 1 次改造只是关掉 6 个开发态用不上的插件,就省下 8 秒,改动量 12 行配置。这一步几乎没有风险,适合作为入手点。
CI 里构建 90 秒以上
产物构建与冷启动是两笔账。第 5 次改造把产物构建从 74 秒降到 31 秒,同时把 CI 缓存命中率提到 87%,一次发布的等待时间少了 40 秒。
多人多机环境不一致
有的机器 12 秒,有的 41 秒,往往是缓存目录与文件监听配置不同。第 7 章给了两条对齐规则与一台基准机的采样方法,先对齐再优化。
和常见讲法差在哪
- 五次改造每一步都有前后耗时,且标了测量方式:同一台机器、清空缓存、跑 3 次取中位数。没有测量方式的提速数字不可信。
- 把“换构建器”排在最后,并写明它的真实收益只有 0.4 秒。很多文章一上来就让你换工具,换完发现还是慢。
- 给了回滚清单:每一步改动对应的回滚动作与验证点,改动失败能在 3 分钟内退回。
交付周期与阅读节奏
开通 10 分钟内可读,5 份配置 diff 随页面下载。7 章建议按改造顺序读,每读完一章就在自己项目里跑一次 3 次取中位数的测量。中位耗时 12 小时,其中复测占 5 小时;如果你的项目依赖少于 800 个,第 1、2 次改造的收益会小很多。
服务条款
14 天内可退。配置 diff 与采样脚本长期可下载。构建器升到大版本后,若配置项失效会在 15 个工作日内补丁;采样脚本本身不依赖具体构建器,可长期使用。
选型建议
冷启动在 10 秒以内的项目,这一期的收益低于投入,可以先做第 1 次改造(关插件)就停。值得完整读的是三种:冷启动超过 20 秒、依赖数超过 1000、或者热更新超过 2 秒。第三种对日常效率影响最大,一天改 50 次代码就是 100 秒的浪费。
读完常见的问题
- Webpack 项目适用吗?
- 前 4 次改造的思路上适用,配置写法不同。文中给了 Webpack 5 的对照要点,没有逐行示例。
- 依赖预构建白名单会不会漏?
- 会。第 2 章给了兜底:漏掉的包在首次访问时会出现一次刷新,日志里能抓到,按日志补进白名单即可。
- 一定要换构建内核吗?
- 不必。前 4 次已经把 41 秒降到 6.4 秒,第 5 次只省 0.4 秒,收益在产物构建上。按你的瓶颈决定。