Webpack Compiler 源码全面解析

Compiler

类图解析：

1. Tapable 基类

Webpack 插件系统的核心，提供钩子注册（plugin）和触发（applyPlugins）能力。Compiler 和 Compilation 均继承此类，支持插件通过生命周期钩子介入构建流程。

2. Compiler 类

• 核心属性

 ◦ `options`：整合 Webpack 配置（入口、出口、Loader 等）  ◦ `hooks`：包含 `run`（构建启动）、`compile`（编译开始）、`emit`（资源生成前）等钩子，插件可监听这些事件  

• 核心方法

 ◦ `run()`：启动构建流程，触发 `beforeRun` 和 `run` 钩子  ◦ `compile()`：创建 `Compilation` 实例，进入模块解析阶段

3. Compilation 类

• 核心属性

 ◦ `modules`：所有被处理的模块集合，包含源码和依赖信息  ◦ `chunks`：代码分块（如通过 `SplitChunksPlugin` 分割的公共模块）  ◦ `assets`：最终输出的文件内容（如 JS、CSS、图片等）  

• 核心方法

 ◦ `addEntry()`：从入口文件递归分析依赖，构建模块依赖图  ◦ `seal()`：冻结依赖图，执行 Tree Shaking 和代码压缩等优化  ◦ `emitAsset()`：将资源写入磁盘，触发 `emit` 钩子

4 协作关系

• 生命周期：Compiler 管理全局构建流程（如初始化配置、触发钩子），而 Compilation 负责单次编译的具体实现（模块解析、优化、输出）

• 实例化：每次构建（包括开发模式下文件变化）时，Compiler 会创建新的 Compilation 实例，确保资源状态隔离。

应用场景示例：
• 插件开发：通过监听 Compiler.hooks.emit 修改输出内容（如删除注释）

• 性能优化：利用 Compilation.modules 分析模块体积，实现按需加载。

---

在前端工程化中，自定义 Webpack 的 Loader 和 Plugin 是扩展构建流程的核心能力。以下从实现原理、开发步骤、典型场景等维度深入解析两者的设计与应用：

---

自定义loader和plugin

一、自定义 Loader 的实现

1. 核心原理与开发步骤

• 本质与作用

Loader 是文件转换器，将非 JS 文件（如 Markdown、CSS）转换为 Webpack 可处理的模块。其开发需遵循单一职责原则，且需保持无状态。

• 实现步骤：

1. 创建函数：导出一个处理文件内容的函数，接收 source（文件内容）作为输入。
2. 处理内容：通过正则或工具库（如 marked、babel）对内容转换，例如将 Markdown 转 HTML。
3. 返回结果：需返回 JS 代码字符串，支持 module.exports 或 ES Modules 导出。
4. 配置使用：在 webpack.config.js 的 module.rules 中通过 test 匹配文件类型并串联 Loader。

2. 同步与异步 Loader

• 同步处理：直接返回结果，适用于简单转换（如字符串替换）。

module.exports = function (content) {return content.replace(/world/g, 'loader'); // 替换文本
};

• 异步处理：通过 this.async() 实现异步操作（如网络请求、文件读取）。

module.exports = function (content) {const callback = this.async();fetchData().then(() => callback(null, processedContent));
};

3. 典型场景示例

• 多语言翻译：替换代码中的 __t('KEY') 为对应语言字符串。

• 资源优化：使用 svgo 压缩 SVG 文件，或通过 imagemin 生成 WebP 图片。

• 语法转换：自定义 Babel Loader 实现 ES6 转 ES5。

---

二、自定义 Plugin 的实现

1. 核心机制与生命周期

• 实现原理：

Plugin 通过监听 Webpack 生命周期钩子（如 emit、done）介入构建流程，操作 compiler 和 compilation 对象。

• 开发步骤：

1. 创建类：定义包含 apply 方法的类，接收 compiler 对象。
2. 注册钩子：在目标钩子（如 emit）中挂载逻辑，操作资源或生成附加文件。
3. 配置使用：在 plugins 数组中实例化插件。

2. 典型场景示例

• 打包报告生成：在 done 钩子中生成包含构建时间、模块大小的 JSON 报告。

• 资源修改：在 emit 阶段遍历 compilation.assets，删除 JS 注释或修改文件内容。

compiler.hooks.emit.tap('MyPlugin', (compilation) => {Object.keys(compilation.assets).forEach(name => {if (name.endsWith('.js')) {const content = compilation.assets[name].source().replace(/\/\*.*?\*\//g, '');compilation.assets[name] = { source: () => content, size: () => content.length };}});
});

• 自动化注入：类似 HtmlWebpackPlugin，动态生成 HTML 并插入脚本。

3. 高级应用

• 自定义钩子：通过 tapable 创建同步/异步钩子，扩展插件间的通信能力。

• 多插件协作：结合其他插件（如 CleanWebpackPlugin）清理构建目录。

---

三、Loader 与 Plugin 的协同与对比

维度	Loader	Plugin
作用层级	单文件处理（如转译、压缩）	全局流程控制（如资源优化、报告生成）
执行时机	模块加载阶段	任意构建阶段（通过钩子介入）
配置方式	module.rules 中定义规则链	plugins 数组实例化
典型工具	babel-loader、css-loader	HtmlWebpackPlugin、TerserPlugin

---

四、调试与优化建议

1. Loader 调试
   • 使用 loader-runner 独立测试逻辑。

   • 通过 this.getOptions() 获取配置参数，结合 schema.json 校验参数合法性。

2. Plugin 性能优化
   • 在 afterEmit 阶段执行耗时操作，避免阻塞主流程。

   • 利用 compilation.fileTimestamps 缓存文件修改时间，减少重复处理。

---

五、总结

自定义 Loader 和 Plugin 是 Webpack 生态灵活性的核心体现。Loader 聚焦于文件级转换，适合语法兼容、资源预处理等场景；Plugin 则通过生命周期钩子实现全局控制，适用于构建优化、自动化注入等复杂需求。两者的协同使用可覆盖从模块处理到工程化优化的全链路需求，开发者可根据具体场景选择合适方案。

---

1. 自定义 Loader：将 Markdown 转换为 HTML。
2. 自定义 Plugin：构建结束发送通知（以控制台模拟为例，实际可扩展为系统通知）。
3. 自定义 Plugin：构建时检测重复依赖并输出警告。

---

样例

🔧 1. 自定义 Markdown 转 HTML Loader

依赖：安装 marked（或 markdown-it）

npm install marked --save-dev

loaders/md-to-html-loader.js

const marked = require('marked');module.exports = function (source) {const html = marked(source);// 返回一段 JS 模块代码，导出 HTML 字符串return `export default ${JSON.stringify(html)}`;
};

webpack.config.js 中配置：

module.exports = {module: {rules: [{test: /\.md$/,use: path.resolve(__dirname, 'loaders/md-to-html-loader.js')}]}
};

---

🔔 2. 自定义构建结束发送通知 Plugin

控制台通知实现（也可以结合 node-notifier 发桌面通知）

plugins/build-notifier-plugin.js

class BuildNotifierPlugin {apply(compiler) {compiler.hooks.done.tap('BuildNotifierPlugin', (stats) => {const time = (stats.endTime - stats.startTime) / 1000;console.log(`✅ 构建完成！耗时 ${time.toFixed(2)} 秒`);});}
}module.exports = BuildNotifierPlugin;

webpack.config.js 中配置：

const BuildNotifierPlugin = require('./plugins/build-notifier-plugin');module.exports = {plugins: [new BuildNotifierPlugin()]
};

可选增强：使用 node-notifier 发系统弹窗提示。

---

🧩 3. 自定义重复依赖检测 Plugin

这个插件会分析所有模块中使用的依赖包并查找是否存在多个版本的情况（如多个 lodash）

plugins/duplicate-dependency-plugin.js

const path = require('path');
const fs = require('fs');class DuplicateDependencyPlugin {apply(compiler) {compiler.hooks.emit.tapAsync('DuplicateDependencyPlugin', (compilation, callback) => {const moduleVersions = {};compilation.modules.forEach((module) => {if (module.resource && module.resource.includes('node_modules')) {const parts = module.resource.split('node_modules' + path.sep);if (parts[1]) {const pkgPath = parts[1].split(path.sep);const name = pkgPath[0].startsWith('@') ? `${pkgPath[0]}/${pkgPath[1]}` : pkgPath[0];const packageJsonPath = path.join(module.resource.split('node_modules')[0], 'node_modules', name, 'package.json');try {const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));if (!moduleVersions[name]) {moduleVersions[name] = new Set();}moduleVersions[name].add(pkg.version);} catch (err) {// 忽略找不到 package.json 的模块}}}});// 输出重复依赖警告Object.entries(moduleVersions).forEach(([name, versions]) => {if (versions.size > 1) {console.warn(`⚠️ 发现重复依赖：${name}，版本有：${[...versions].join(', ')}`);}});callback();});}
}module.exports = DuplicateDependencyPlugin;

webpack.config.js 中配置：

const DuplicateDependencyPlugin = require('./plugins/duplicate-dependency-plugin');module.exports = {plugins: [new DuplicateDependencyPlugin()]
};

---

📦 最终项目结构参考

webpack-project/
├── loaders/
│   └── md-to-html-loader.js
├── plugins/
│   ├── build-notifier-plugin.js
│   └── duplicate-dependency-plugin.js
├── src/
│   └── index.js
├── content/
│   └── example.md
├── webpack.config.js
└── package.json

---