跳到正文
小佑Blog 站点标识小佑Bloglordblog.cn

构建提速:冷启动从 41 秒到 6 秒的五次改造

框架与工程更新 2026-11-12构建提速

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 秒,收益在产物构建上。按你的瓶颈决定。

同方向的其他两期