# 揭示内部原理

此章节描述 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 (opens new window) 会将一个 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。其中包含：

以及除 ./app.jsx外的所有依赖

然后会为 ./app.jsx创建 non-initial chunk，这是因为 ./app.jsx是动态导入的。

Output:

默认情况下，这些 non-initialchunk 没有名称，因此会使用唯一 ID 来替代名称。在使用动态导入时，我们可以通过使用 magic comment(魔术注释) 来显式指定 chunk 名称：

import(
  /* webpackChunkName: "app" */
  './app.jsx'
).then((App) => {
  ReactDOM.render(<App />, root);
});

Output:

输出文件的名称会受配置中的两个字段的影响：

这些字段中会有一些 占位符 。常用的占位符如下：

[id]- chunk id（例如 [id].js-> 485.js）
[name]- chunk name（例如 [name].js-> app.js）。如果 chunk 没有名称，则会使用其 id 作为名称
[contenthash]- 输出文件内容的 md4-hash（例如 [contenthash].js-> 4ea6ff1de66c537eb9b2.js）