webpack 源码研究

🔁 模块连接管理 copyOutgoingModuleConnections(oldModule, newModule, filterConnection) 作用：将旧模块的所有出站连接（即它依赖的模

🧱 核心数据结构 this._dependencyMap 类型：WeakMap<Dependency, ModuleGraphConnection | null> 用途：存储无来源模块的依赖与连接关系

ModuleGraphModule 类主要属性说明 incomingConnections 类型：SortableSet<ModuleGraphConnection> 说明：当前模块的入边连接（谁依赖

makeSerializable(Module, "webpack/lib/Module"); 作用： 使 Module 类可以被序列化（用于缓存、持久化等功能）。 hasEqualsChunks 属

这段代码是 Webpack 中模块基类 Module 的一部分，提供了模块在构建过程中所需的核心行为定义，供子类（如 NormalModule）继承和重写。它主要包含源码生成、模块缓存管理、串行化支持

这段代码是 Webpack 中模块系统的基类 Module 的实现，提供了模块在整个构建生命周期中的核心功能接口。它定义了一套通用的逻辑，用于管理模块的构建状态、错误和警告收集、模块间依赖关系分析、哈

这部分 Module 类代码是 Webpack 构建系统中的“模块描述对象”功能实现核心，负责模块与 chunk 的关联管理、导出分析、依赖注册与清理等关键任务，支撑了模块图和 chunk 图构建、代

核心作用总结 该类作为 Webpack 构建系统中模块表示的核心抽象，维护了从模块定义、构建信息、优化状态到 Chunk 映射等全生命周期数据。 同时提供了与 ModuleGraph 和 ChunkG

deprecatedNeedRebuild 函数总结 作用： 这是一个已废弃的兼容性函数，用于判断一个模块是否需要重新构建（rebuild），但它已经被新版的 module.needBuild(con

serialize(context) 功能总结： 将当前 NormalModule 实例的内部状态序列化（写入缓存），以便后续构建中可以跳过重复的编译过程。 关键点： 用 context.write(

codeGeneration(...) 功能总结： 用于执行模块的代码生成阶段，将构建后的模块内容根据不同的 sourceType（如 javascript, css 等）生成最终用于输出的代码，处理

_initBuildHash(compilation) 作用： 初始化模块的构建哈希值，作为当前模块内容的唯一标识。该哈希将用于缓存判断与增量构建。 逻辑概览： 使用配置中定义的哈希算法创建哈希对象。

这是 Webpack 中 NormalModule 的核心方法之一，负责执行模块构建，主要包括： 创建 loaderContext，为所有 loader 提供统一上下文环境； 调用 runLoader

1. getUnsafeCacheData() 用处： 将模块的某些关键信息（如 parserOptions 和 generatorOptions）保存下来，以便未来可以从缓存中快速恢复模块状态。用于

一、getCompilationHooks(compilation) 静态方法 用于为某个 Compilation 实例附加或获取一组 模块构建过程的钩子（NormalModuleCompilatio

这段代码主要是为 Webpack 中的 NormalModule 模块构建逻辑 提供一系列： 类型定义（Type Definitions） ：包括 SourceMap、LoaderItem、Norma

cleanupForCache() : 作用：清理缓存时调用的清理方法。遍历所有恢复的不安全缓存条目，执行相关的清理操作，包括清除模块的 Chunk 图、模块图，并执行模块的自清理操作。 create

1. 构造函数参数 context: 模块解析的上下文（如当前工作目录）。 fs: 用于文件操作的文件系统对象。 resolverFactory: 解析器工厂，用于创建各种解析器。 options:

核心类型定义（Typedefs） ModuleSettings：提取了模块规则中会影响模块构建的一些设置项（如 type、parser、resolve 等）。 CreateData：模块创建时传入的数

Compilation.prototype.factorizeModule 的重载与注册方式。 移除的旧 API 接口 modifyHash 和 cache，并通过 util.deprecate 提示