Webpack 不是边读边打包:先建完图,才切块出文件

Webpack 的打包不是从入口一路拼接文件,而是先把每个 import 解析成模块、连成依赖图,再在 seal 阶段把模块分组成 chunk、生成资产,最后统一写盘。理解 make 与 seal 的分工,才能解释为什么 entry 只有一个产物却有很多个、为什么 loader 跑完还没开始切 chunk、为什么改一个文件只有部分 contenthash 变化。常见的误解是把 loader 当插件、把 chunk 当文件、以为 splitChunks 发生在读文件时。读完你能按阶段定位构建慢在哪,用缓存、确定性 id 与 processAssets 把流程调稳,而不是一慢就换构建工具。

是什么

Webpack 是一个以模块依赖图为中心的打包器。它从 entry 出发,把每一次 import 或 require 解析成一个 module,递归地把整张图建完,再把图里的模块分配给 chunk,生成最终资产。一句话直觉:它像装修队先进场量完所有房间、算清管线,再统一裁板下料,而不是锯一块板就钉一块。

这个流程解释了日常最常见的几个现象:entry 只写了一个,dist 里却躺着好几个 JS;改了业务代码,vendor 的 contenthash 纹丝不动;loader 明明跑完了,切 chunk 的插件才开始工作。官方把一次构建概括为 make、seal、emit 三段(Codebase Overview),面试里常说的“初始化—编译—输出”只是外层壳。

典型场景是构建调优与故障排查:构建从二十秒涨到三分钟,你要判断慢在解析与 loader,还是慢在 chunk 优化与压缩;产物数量突然翻倍,你要分清是动态 import、splitChunks 还是 runtime 被抽了出来。

核心原理

先记住五个对象,后面所有现象都能挂上去:Compiler 由配置创建一次,持有文件系统与 watcher,驱动整个生命周期;Compilation 每次构建新建一个,装本次的模块图与 chunk,构建结束就丢弃;Module 是被构建的东西,可以是一个文件、一个 asset 或一个 external;Dependency 是模块之间的一条引用,附带把引用改写成运行时调用的模板;Chunk 是一组模块,最终被发射成资产。

把这条链路串成面试可复述的顺序:解析命令行与配置得到 options,创建 Compiler 并挂载插件,run 触发 compile,创建 Compilation 并 addEntry,make 递归建图,seal 切块、优化、生成代码与 hash,emit 写资产,最后 done。watch 模式下 Compiler 只创建一次,每次变更新建一个 Compilation,未变的模块尽量从缓存复用,所以第二次构建的提速主要来自 make 阶段的复用,而不是 seal 变快了。

make:把图长出来。 Compiler 调 compile,创建 Compilation,然后 addEntry。入口先经过 enhanced-resolve 解析成绝对路径,交给 NormalModuleFactory 创建模块;工厂按 module.rules 匹配出 loader 链,交给 loader-runner 执行。官方 Loaders 文档写得很明确:普通 loader 从右往左(从下往上)跑,pitch loader 从左往右跑;某个 pitch 返回了值,右侧 loader 的 normal 阶段就被跳过,直接从左边继续。loader 全部跑完,JavaScript 模块的产物才交给 acorn 解析,扫出 import 与 export 以及其它依赖,再入队递归。图停止生长,make 结束。

这里有个关键事实:make 结束时只有模块图,还没有 chunk,也没有任何输出文件。你在 loader 里拿到的始终是单个模块的源码,不可能是最终 bundle;也正因如此,loader 里做不了分包,它根本看不到全局的图。

seal:把图切成块。 seal 阶段的核心动作是 buildChunkGraph:把模块图转成 chunk 图,入口模块进 entry chunk,动态 import() 产生的异步块在这里被物化成独立 chunk。围绕这条图依次跑 optimizeDependencies、optimizeModules、optimizeChunks 等钩子,SplitChunksPlugin 就在 optimizeChunks 阶段决定哪些共享模块被抽走。然后分配 module id 与 chunk id,执行 codeGeneration 为每个模块生成代码,chunk 模板把模块包进函数、拼上 runtime,最后 createHash 计算 hash,processAssets 阶段生成并修改资产(Compilation Hooks)。

产物不是把源码按顺序拼起来。每个模块被包成一个函数,以 id 为键登记,runtime 提供 __webpack_require__ 负责缓存与加载;异步 chunk 则在运行时按需拉取。所以 chunk 是模块分组,资产才是最终文件,两者并非一一对应:一个 chunk 可以同时带出 JS 与 CSS 等多个资产。

emit:把资产写下去。 Compiler.emitAssets 把 compilation.assets 里的内容写到 output.path。webpack-dev-server 不走磁盘,它把产物放进内存文件系统由中间件直接服务;webpack --watch 则是真的写盘。

const webpack = require('webpack');
const compiler = webpack({
  mode: 'development',
  entry: './src/index.js',
  output: { path: __dirname + '/dist' },
});

compiler.hooks.make.tap('demo', () => console.log('1 make'));
compiler.hooks.thisCompilation.tap('demo', (compilation) => {
  compilation.hooks.seal.tap('demo', () => console.log('2 seal'));
  compilation.hooks.processAssets.tap('demo', (assets) => {
    console.log('3 processAssets', Object.keys(assets));
  });
});
compiler.hooks.emit.tap('demo', () => console.log('4 emit'));
compiler.run((err) => {
  if (err) throw err;
});

这段输出会稳定地告诉你:make 在模块构建前触发,seal 在切块开始时触发,processAssets 晚于 seal,emit 最后。排查构建慢时,先看时间落在哪两行之间,比盯着总耗时有用得多。

常见考点与误区

  • 误区一:loader 是“打包后处理文件”的。 loader 在 make 阶段逐模块执行,输入是模块源码,输出还得是模块源码;它早于 chunk 划分,也看不到最终 bundle。面试问“loader 和 plugin 的区别”,只答“一个处理文件一个处理功能”会露怯:loader 是模块级转换,plugin 通过 Tapable 挂到 Compiler 或 Compilation 的钩子上,能改依赖、改 chunk、改资产。
  • 误区二:entry 一个,产物就一个。 entry 只决定入口 chunk。动态 import、splitChunks、runtimeChunk、CSS 抽离都会增加资产;chunk 和文件也不是一一对应,一个 chunk 可以同时带出 JS 与 CSS 等多个资产。
  • 考点三:loader 的执行顺序。 use 数组写成 [a, b, c] 时,normal 阶段是 c→b→a,pitch 阶段是 a→b→c;pitch 有返回值时会截断右侧链。配置里把 style-loader 写在 css-loader 左边不是风格问题,是执行顺序问题。
  • 误区四:splitChunks 在读文件时就分好包了。 它在 seal 的 optimizeChunks 阶段才运行,输入是已经建好的模块图;所以在 loader 里改 import 路径能影响分包,在 loader 里读 splitChunks 配置则毫无意义。
  • 考点五:三种 hash。 hash 是整个 compilation 的 hash,任何改动都可能让它变;chunkhash 按 chunk;contenthash 按资产内容。要做长缓存,用 contenthash,并把 runtime 单独抽成 chunk,否则 runtime 一变,所有 chunk 的映射都跟着失效。
  • 误区六:seal 之后不能改产物。 能改,但要挂在 processAssets 的合适 stage,用 emitAsset 或 updateAsset,而不是直接给 compilation.assets 赋值;webpack 5 对 assets 做了封装,直接改对象在部分场景下不生效。
  • 误区七:production 只是多跑一次压缩。 mode 会切一整套优化默认值:模块与 chunk 的 id 策略、scope hoisting、压缩、副作用分析等。把它当成“压缩开关”,就解释不了为什么开发环境能跑、生产环境报错。

实践建议

  • 先分段计时,再谈优化。 用 webpack --profile 或 SpeedMeasurePlugin 看 loader、解析、seal、压缩各占多少。时间在 make,优先查 resolve.extensions 过长、loader 全量跑 node_modules、source-map 类型过重;时间在 seal,优先查 splitChunks 组合爆炸、压缩并行度,以及是否有插件在 processAssets 里做重活。
  • 缓存要缓存对阶段。 webpack 5 的 cache: { type: 'filesystem' } 会把模块与 chunk 的中间结果落到磁盘,CI 里持久化缓存目录能省掉大量 make;但 loader 调了 this.cacheable(false),或者配置里塞了每次新建的函数与正则,命中率会掉。升级依赖后记得让缓存 key 带上版本。
  • 让 id 与 runtime 稳定。 显式设置 optimization.moduleIds 与 chunkIds 为 deterministic,再配 runtimeChunk: 'single',把 runtime 的映射从业务 chunk 里剥出来,contenthash 才不会因为一个模块 id 变动而集体失效。
  • loader 做单文件转换,plugin 做全局决策。 不要在 loader 里读环境、发请求、改全局配置;这些放进 plugin 的 make、seal、processAssets 钩子,既避免每模块重复执行,也让职责和阶段对得上。
  • 别把 dev 的结论套到 prod。 dev-server 在内存里服务、不压缩、保留完整模块路径;生产走另一套优化与 hash。用开发构建时间判断生产性能,和用开发包体积判断线上体积一样不可靠。
  • 看产物用 chunk 视角。 用 webpack-bundle-analyzer 看每个 chunk 由哪些模块组成,再对照 stats 的 chunks 字段确认 chunk 与文件的映射,不要只看 dist 目录里的文件名猜。

一句话总结:Webpack 的产物不是“读出来的”,而是先建图、再切块、最后生成的;把 make 和 seal 分开看,构建问题就少了一半。

相关阅读

← 返回文章志