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

ES 模块拆包:把 1.2MB 的单包切成 4 个能独立缓存的块

语言基础更新 2026-11-12ES 模块拆包

2025 年 12 月,一个管理后台的首屏包停在 1.2MB,4G 网络下首屏可交互要 4.6 秒。我用 9 章把这个包切成 4 块,主包落到 486KB,二次访问的缓存命中率从 41% 升到 92%。

这一期要解的问题

很多项目的包体是被“顺手”撑大的。业务代码可能只有 300KB,剩下的 900KB 散在六个地方:全量引入的工具库、重复打包的设计系统、只在某个弹窗里用一次的编辑器、被同步 import 的图表库、漏掉的副作用标记,以及两套没合并的日期库。这些依赖在 import 图里看不出来,只有把构建产物按模块倒排一遍,才会露出马脚。

拆包不是简单开一个 manualChunks。块切得太碎,浏览器要发的请求从 1 个变成 14 个,弱网下反而更慢;切得太粗,任何一处改动都会让整块缓存失效。这 9 章的顺序是:先量、再找、后切、最后把阈值写进流水线。

九个章节

  • 第 1 章 先量:用 Performance 面板把 1.2MB 拆成 7 段,标出首屏真正需要的 486KB
  • 第 2 章 import 的两种写法:静态导入与动态导入在同一段业务代码里的代价差
  • 第 3 章 依赖倒排:从产物里找出 6 个隐形依赖,逐个标出体积与引用位置
  • 第 4 章 manualChunks 的三种切法:按路由、按依赖、按变更频率,附各自的失效范围测算
  • 第 5 章 modulepreload:加与不加的网络瀑布对比,13 个请求变 6 个的那一次
  • 第 6 章 CSS 拆分:样式跟着组件走之后,首屏出现的 0.3 秒无样式闪烁怎么处理
  • 第 7 章 内容哈希:4 个块的哈希策略与一次改动引发的连锁失效
  • 第 8 章 回归:用 200 条路由的构建日志做逐条比对,找出漏网的同步引入
  • 第 9 章 收尾:把 170KB 主包阈值写进 CI,超线即拦
// 第 4 章示例:按变更频率切块,而不是按文件名切
const groups = {
  vendor: ['vue', 'pinia', 'vue-router'],
  charts: ['echarts', 'zrender'],
  editor: ['@tiptap/core', '@tiptap/starter-kit'],
};
const chunkOf = (id) => {
  for (const [name, list] of Object.entries(groups)) {
    if (list.some((pkg) => id.includes(`node_modules/${pkg}`))) return name;
  }
  return id.includes('node_modules') ? 'vendor-misc' : undefined;
};

参数与交付

项目内容
难度中高,需要能看懂构建产物与网络面板
章节9 章,含 3 段可运行代码与 2 份构建日志
实测时长11 小时(读 6 小时 + 跑练习 5 小时)
验证环境Vite 8.0 / Node 26.1 / Chrome 142 / Safari 26.0
前置知识写过 6 个月以上业务代码,知道什么是 Tree Shaking
配套资源只读仓库、assert 断言脚本、200 条路由的回归日志
更新节奏每季度同步一次构建工具版本差异
阅读授权单账号,可读 24 个月

三个会用到它的场合

接手一个首屏超过 3 秒的老后台

老后台往往没有构建分析,先跑一遍 bundle 可视化能吓一跳:某个月份组件库单独占了 214KB。第 3 章的倒排方法可以直接套,半天能列出前 6 个体积来源。

要给多条业务线做公共壳子

多条线共用导航、登录、权限校验,但页面各写各的。按变更频率切块后,壳子一年改动不到 10 次,业务块的哈希每次发布都变,壳子那 3 块可以长期留在浏览器缓存里。

上线前的包体评审

评审会前把第 9 章的阈值脚本接进流水线,主包超过 170KB 直接失败。这套规则在一个 40 人的团队里跑了 7 个月,拦下 4 次超线提交,其中 2 次是误引了整包图标字体。

和常见讲法差在哪

  • 每章都配一条断言脚本,跑绿才算过。脚本不是检查代码有没有写,而是检查产物:块数、体积、请求数、缓存头。照着截图改代码的教程很多,能验证结果的少。
  • 所有数字来自同一份构建日志。1.2MB、486KB、92% 这些值在仓库的 log 目录里能逐行对上,不是估的。
  • 切法给了三种,并且把三种的失效范围算给你看。只教一种切法的专栏,换个项目就不适用。

交付周期与阅读节奏

付款后 10 分钟内开通阅读权限,24 小时内发出仓库邀请。仓库是只读权限,可拉取、可提 issue。9 章按“量、查、切”三轮排,每轮三章,建议每轮之间隔一天,让构建结果沉淀一下再进下一轮。按 214 份结课记录,中位时长 11 小时,最慢的一位用了 3 周,卡在第 5 章的预加载顺序上。

服务条款

开通后 14 天内可无理由退款,退款后仓库权限同步收回。仓库长期可拉取,专栏内容在有效期内随版本更新,更新点写在每章末尾的更新记录里,带日期与改动行号。章节内代码若因工具版本升级失效,会在 15 个工作日内补丁,并单独发一条更新通知。

选型建议

如果你的首屏包在 300KB 以内,或者项目只有一个页面,这一期可以先放着,收益不明显。真正值得投入的是三种情况:包体超过 800KB、二次访问占比高、或者正在把多个子系统合并成一个壳。第三种情况收益最大,壳子与业务的缓存周期能差出 6 倍以上。

读完常见的问题

只用 Webpack 的项目能读吗?
能。第 4 章的三种切法在 Webpack 5 里有对应写法,仓库里另放了一份 webpack.config.js 对照版本,逻辑一致,API 不同。
拆成 4 块是硬性要求吗?
不是。4 块是那个项目的结论:壳子、图表、编辑器、业务。你的项目按变更频率算出来可能是 3 块或 6 块,第 4 章给了测算表。
需要会看构建产物吗?
会看文件名和体积就够,第 1 章教了怎么用可视化面板按模块倒排,不需要读编译后的代码。

同方向的其他两期