Webpack 模块

在模块化编程中，开发者将程序分解为功能离散的 chunk，并称之为 模块。

每个模块都拥有小于完整程序的体积，使得验证、调试及测试变得轻而易举。

何为 webpack 模块

与 Node.js 模块相比，webpack 模块 能以各种方式表达它们的依赖关系。

  • ES2015 import 语句
  • CommonJS require() 语句
  • AMD define 和 require 语句
  • css/sass/less 文件中的 @import 语句。
  • stylesheet url(...) 或者 HTML <img src=...> 文件中的图片链接。

支持的模块类型

Webpack 天生支持如下模块类型：

loader 向 webpack 描述了如何处理非原生模块，并将相关依赖引入到你的 bundles中。

webpack 社区已经为各种流行的语言和预处理器创建了 loader，其中包括：

总得来说，webpack 提供了可定制，强大且丰富的 API，允许在 任何技术栈 中使用，同时支持在开发、测试和生产环境的工作流中做到 无侵入性。

模块解析

resolver 是一个帮助寻找模块绝对路径的库。

一个模块可以作为另一个模块的依赖模块，然后被后者引用，如下：

1
2
3
import foo from 'path/to/module';
// 或者
require('path/to/module');

所依赖的模块可以是来自应用程序的代码或第三方库。

当打包模块时，webpack 使用 enhanced-resolve 来解析文件路径。

webpack 中的解析规则

使用 enhanced-resolve，webpack 能解析三种文件路径：

绝对路径

1
2
import '/home/me/file';
import 'C:\\Users\\me\\file';

相对路径

1
2
import '../src/file1';
import './file2';

在这种情况下，使用 import 或 require 的资源文件所处的目录，被认为是上下文目录。在 import/require 中给定的相对路径，会拼接此上下文路径，来生成模块的绝对路径。

模块路径

1
2
import 'module';
import 'module/lib/file';

在 resolve.modules 中指定的所有目录中检索模块。

TIP

如果 package 中包含 package.json 文件，那么在 resolve.exportsFields 配置选项中指定的字段会被依次查找，package.json 中的第一个字段会根据 package 导出指南确定 package 中可用的 export。

一旦根据上述规则解析路径后，resolver 将会检查路径是指向文件还是文件夹。

如果路径指向文件：

  • 如果文件具有扩展名，则直接将文件打包。
  • 否则，将使用 resolve.extensions 选项作为文件扩展名来解析，此选项会告诉解析器在解析中能够接受那些扩展名（例如 .js，.jsx）。

如果路径指向一个文件夹，则进行如下步骤寻找具有正确扩展名的文件：

  • 如果文件夹中包含 package.json 文件，则会根据 resolve.mainFields 配置中的字段顺序查找，并根据 package.json 中的符合配置要求的第一个字段来确定文件路径。
  • 如果不存在 package.json 文件或 resolve.mainFields 没有返回有效路径，则会根据 resolve.mainFiles 配置选项中指定的文件名顺序查找，看是否能在 import/require 的目录下匹配到一个存在的文件名。
  • 然后使用 resolve.extensions 选项，以类似的方式解析文件扩展名。

Webpack 会根据构建目标，为这些选项提供合理的默认配置。

解析 loader

loader 的解析规则也遵循特定的规范。但是 resolveLoader 配置项可以为 loader 设置独立的解析规则。

缓存

每次文件系统访问文件都会被缓存，以便于更快触发对同一文件的多个并行或串行请求。在 watch 模式 下，只有修改过的文件会被从缓存中移出。如果关闭 watch 模式，则会在每次编译前清理缓存。

欲了解更多上述配置信息，请查阅 Resolve API。

模块联合

多个独立的构建可以组成一个应用程序，这些独立的构建之间不应该存在依赖关系，因此可以单独开发和部署它们。这通常被称作微前端，但并不仅限于此。

底层概念

本地模块即为普通模块，是当前构建的一部分。

远程模块不属于当前构建，并在运行时从所谓的容器加载。

加载远程模块被认为是异步操作。当使用远程模块时，这些异步操作将被放置在远程模块和入口之间的下一个 chunk 的加载操作中。如果没有 chunk 加载操作，就不能使用远程模块。

容器是由容器入口创建的，该入口暴露了对特定模块的异步访问。暴露的访问分为两个步骤：

  1. 加载模块（异步的）
  2. 执行模块（同步的）

步骤 1 将在 chunk 加载期间完成。步骤 2 将在与其他（本地和远程）的模块交错执行期间完成。

容器可以嵌套使用，容器可以使用来自其他容器的模块。容器之间也可以循环依赖。

高级概念

// TODO

Module Federation | webpack 中文文档 (docschina.org)