1. Compiler（编译器）

webpack的Compiler模块是通过webpack CLI或webpack api或webpack配置文件传递的所有选项创建一个编译实例的主引擎（engine）。

它是由webpack.Compiler下的webpack api导出的。

webpack通过实例化它，然后调用run方法来使用编译器。下面是一个关于如何使用Compiler的简单示例。事实上，这与webpack本身的使用方式非常接近。

compiler-example

// 可以从webpack包中导入
import {Compiler} from 'webpack';

// 创建一个新的编译器实例
const compiler = new Compiler();

// 填充所有必需的选项
compiler.options = {...};

// 创建一个插件
class LogPlugin {
  apply (compiler) {
    compiler.plugin('should-emit', compilation => {
      console.log('should I emit?');
      return true;
    })
  }
}

// 将编译器应用到插件中
new LogPlugin().apply(compiler);

/* 添加其他支持插件 */

// run 后执行的完整回调
const callback = (err, stats) => {
  console.log('Compiler has finished execution.');
  // 显示统计数据（stats）……
};

// 在编译器和回调中调用 run
compiler.run(callback);

Compiler就是我们所称的Tapable实例。我们的意思是，它混合了Tapable的类来吸收功能来在它自己上注册和调用插件。大多数用户面对第一次在Compiler上注册的插件。编译器的工作可以被浓缩成以下要点：

• 通常有一个编译器的主实例。可以创建子编译器来委派特定的任务。

• 创建编译器的许多复杂性都是为了填充它的所有相关选项。

• webpack的WebpackOptionsDefaulter 和WebpackOptionsApply专门用于提供带有所需的所有初始数据的Compiler。

• Compiler根本上只是一个函数，它执行最小的功能来维持生命周期的运行。它将所有的loading/bundling/writing工作委派给各种插件。

• new LogPlugin(args).apply(compiler)将插件注册到Compiler的生命周期中任何一个特定的钩子事件。

• Compiler暴露一个run方法，该方法启动了webpack的所有编译工作。完成后，它应该调用被传递的callback。日志统计和错误的所有收尾工作都在这个回调函数中完成。

1.1. 观察（watching）

Compiler支持监视文件系统的“观察模式（watch mode）”，并在文件系统更改时重新编译。在观察模式下时，编译器将会发出额外的事件"watch-run", "watch-close", 和 "invalid"。这通常在开发中使用，通常是在webpack-dev-server等工具的底层，因此开发人员不需要每次都手动重新编译。

有关观察模式的更多细节，请参见Node.js API 文档或者CLI watch options。

1.2. 多变异器（MultiCompiler）

这个模块，多编译器，允许webpack在单独的编译器中运行多个配置。

如果webpack的NodeJS api中的options参数是options数组，webpack将为数组的每一项应用独立的编译器，并在每次编译器执行结束时调用callback。

var webpack = require('webpack');

var config1 = {
  entry: './index1.js',
  output: {filename: 'bundle1.js'}
}
var config2 = {
  entry: './index2.js',
  output: {filename:'bundle2.js'}
}

webpack([config1, config2], (err, stats) => {
  process.stdout.write(stats.toString() + "\n");
})

1.3. 事件钩子（Event Hooks）

这是编译Compiler暴露的的所有事件钩子的参考指南。

1.4. 用法

下面是一个异步emit事件处理程序的例子:

compiler.plugin("emit", function(compilation, callback) {
  // Do something async...
  setTimeout(function() {
    console.log("Done with async work...");
    callback();
  }, 1000);
});