此章节描述 webpack 内部实现,对于插件开发人员可能会提供帮助
打包,是指处理某些文件并将其输出为其他文件的能力。
但是,在输入和输出之间,还包括有 模块, 入口起点, chunk, chunk 组和许多其他中间部分。
项目中使用的每个文件都是一个 模块
./index.js
import app from './app.js';
./app.js
export default 'the app';
通过互相引用,这些模块会形成一个图(ModuleGraph
)数据结构。
在打包过程中,模块会被合并成 chunk。
chunk 合并成 chunk 组,并形成一个通过模块互相连接的图(ModuleGraph
)。
那么如何通过以上来描述一个入口起点:在其内部,会创建一个只有一个 chunk 的 chunk 组。
./webpack.config.js
module.exports = {
entry: './index.js',
};
这会创建出一个名为 main
的 chunk 组(main
是入口起点的默认名称)。
此 chunk 组包含 ./index.js
模块。随着 parser 处理 ./index.js
内部的 import 时, 新模块就会被添加到此 chunk 中。
另外的一个示例:
./webpack.config.js
module.exports = {
entry: {
home: './home.js',
about: './about.js',
},
};
这会创建出两个名为 home
和 about
的 chunk 组。
每个 chunk 组都有一个包含一个模块的 chunk:./home.js
对应 home
,./about.js
对应 about
一个 chunk 组中可能有多个 chunk。例如,SplitChunksPlugin 会将一个 chunk 拆分为一个或多个 chunk。
chunk 有两种形式:
initial(初始化)
是入口起点的 main chunk。此 chunk 包含为入口起点指定的所有模块及其依赖项。non-initial
是可以延迟加载的块。可能会出现在使用 动态导入(dynamic imports) 或者 SplitChunksPlugin 时。每个 chunk 都有对应的 asset(资源)。资源,是指输出文件(即打包结果)。
webpack.config.js
module.exports = {
entry: './src/index.jsx',
};
./src/index.jsx
import React from 'react';
import ReactDOM from 'react-dom';
import('./app.jsx').then((App) => {
ReactDOM.render(<App />, root);
});
这会创建出一个名为 main
的 initial chunk。其中包含:
./src/index.jsx
react
react-dom
以及除 ./app.jsx
外的所有依赖
然后会为 ./app.jsx
创建 non-initial chunk,这是因为 ./app.jsx
是动态导入的。
Output:
/dist/main.js
- 一个 initial
chunk/dist/394.js
- non-initial
chunk默认情况下,这些 non-initial
chunk 没有名称,因此会使用唯一 ID 来替代名称。
在使用动态导入时,我们可以通过使用 magic comment(魔术注释) 来显式指定 chunk 名称:
import(
/* webpackChunkName: "app" */
'./app.jsx'
).then((App) => {
ReactDOM.render(<App />, root);
});
Output:
/dist/main.js
- 一个 initial
chunk/dist/app.js
- non-initial
chunk输出文件的名称会受配置中的两个字段的影响:
output.filename
- 用于 initial
chunk 文件output.chunkFilename
- 用于 non-initial
chunk 文件initial
和 non-initial
的 chunk 时,可以使用 output.filename
。这些字段中会有一些 占位符。常用的占位符如下:
[id]
- chunk id(例如 [id].js
-> 485.js
)[name]
- chunk name(例如 [name].js
-> app.js
)。如果 chunk 没有名称,则会使用其 id 作为名称[contenthash]
- 输出文件内容的 md4-hash(例如 [contenthash].js
-> 4ea6ff1de66c537eb9b2.js
)