Webpack 源码执行流程详解

a-loader.pitch → b-loader.pitch（有返回值）→ 截断！
  ↓
跳过 c-loader.pitch、c-loader.normal、b-loader.normal
  ↓
直接执行 a-loader.normal（接收 pitch 返回值）

// 简化的 loader 执行流程
function iteratePitchingLoaders(options, loaderContext, callback) {
  if (loaderIndex < loaders.length) {
    const result = currentLoader.pitch.apply(loaderContext, args);

    if (result !== undefined) {
      // pitch 有返回值 → 跳过后续，回退执行 normal
      loaderIndex--;
      iterateNormalLoaders(options, loaderContext, [result], callback);
    } else {
      // 继续下一个 pitch
      loaderIndex++;
      iteratePitchingLoaders(options, loaderContext, callback);
    }
  } else {
    // pitch 全部完成 → 读取资源 → 进入 normal 阶段
    processResource(options, loaderContext, callback);
  }
}

// webpack/lib/Compiler.js（约第 424 行）
run(callback) {
  const onCompiled = (err, compilation) => {
    if (err) return finalCallback(err);

    // emit 阶段
    this.hooks.emit.callAsync(compilation, (err) => {
      if (err) return finalCallback(err);

      // 写入文件系统
      emitAssets(compilation, (err) => {
        if (err) return finalCallback(err);

        // done 钩子
        this.hooks.done.callAsync(stats, finalCallback);
      });
    });
  };

  // beforeRun → run → compile
  this.hooks.beforeRun.callAsync(this, (err) => {
    if (err) return finalCallback(err);

    this.hooks.run.callAsync(this, (err) => {
      if (err) return finalCallback(err);
      this.compile(onCompiled);
    });
  });
}

// webpack/lib/Compiler.js（约第 1163 行）
compile(callback) {
  const params = {
    normalModuleFactory: this.createNormalModuleFactory(),
    contextModuleFactory: this.createContextModuleFactory(),
  };

  this.hooks.beforeCompile.callAsync(params, (err) => {
    if (err) return callback(err);

    this.hooks.compile.call(params);

    // 创建 Compilation 实例
    const compilation = new Compilation(this);

    this.hooks.thisCompilation.call(compilation, params);
    this.hooks.compilation.call(compilation, params);

    // make 阶段：编译模块
    this.hooks.make.callAsync(compilation, (err) => {
      if (err) return callback(err);

      compilation.finish((err) => {
        if (err) return callback(err);

        // seal 阶段：优化
        compilation.seal((err) => {
          if (err) return callback(err);

          this.hooks.afterCompile.callAsync(compilation, callback);
        });
      });
    });
  });
}

// EntryPlugin 中注册 make 钩子
compiler.hooks.make.tapAsync('EntryPlugin', (compilation, callback) => {
  compilation.addEntry(context, entry, name, callback);
});

const emitAssets = (compilation, callback) => {
  for (const filename in compilation.assets) {
    const source = compilation.assets[filename];
    fs.writeFile(path.join(outputPath, filename), source, callback);
  }
};

# 查找 Hook 注册位置
grep -rn "hooks.make.tap" webpack/lib/
grep -rn "hooks.emit.tapAsync" webpack/lib/
grep -rn "hooks.run.tapPromise" webpack/lib/