前言

先来看关于webpack打包的3个问题。

三个问题

第一个问题

先来看一个问题,项目中的json文件,如何使用webpack进行处理?

如果我们希望把json文件当做静态配置,例如有如下json文件

  1. {
  2. "version": "1.0.0",
  3. "name": "config"
  4. }

在其他模块中引用:

  1. // index.js
  2. import config from './config';
  3. console.log(config); // {version: '1.0.0', name: 'config'}

要实现上面的效果,应该如何配置?

如果我们希望把json文件当做静态资源加载,例如

  1. // index.js
  2. import axios from 'axios';
  3. import config from './config';
  4. axios(config)
  5. .then(res => {
  6. console.log(res.data); // {version: '1.0.0', name: 'config'}
  7. });

这种效果又怎么实现?

第二个问题

我们知道webpack可以分包打包,而且html-webpack-plugin会帮助我们管理分包文件的加载顺序,通常打包出来的html中script会是这样的

  1. <script src="static/js/275.ffbe1.chunk.js"></script>
  2. <script src="static/js/main.d9933.chunk.js"></script>

因为main中模块依赖275.ffbe1 chunk中的模块,因此先加载275.ffbe1.chunk.js。

那么如果我们加载chunk的顺序有问题(先加载main),会不会报错呢?如果不会报错,webpack是怎么保证这种容错的呢?

第三个问题

对于动态加载的模块,路径是动态生成的,比如

  1. const Component = React.lazy(() => import(`~/page/${component}`));

或者

  1. const loadingImgSrc = require(`~/img/${skin}.loading.png`);

动态的路径只有在执行时候才能确定,webpack在打包时候并不能知道具体路径,那么webpack是如何处理的呢?

概述

上面问题虽然在平时工作的大部分项目中不会遇到,但是对于我们深入理解webpack原理、应对可能遇到的疑难杂症和特殊需求以及应付有些深度的面试都大有帮助。

阅读本文可以获知上面3个问题的答案并了解:

  1. webpack模块的解析过程(如何处理不同类型模块,用户如何根据配置控制模块解析行为)。
  2. 模块打包的原理(对于正常打包、动态依赖的打包和分片打包,webpack运行时是如何工作的)。
  3. 模块路径解析规则。

模块解析

模块解析过程

模块解析,就是分析模块的导入(依赖)和导出的过程。模块解析在webpack打包过程中有非常重要的地位。

我们先来看下webpack打包过程,大致过程可以描述为:webpack从入口开始构建依赖图,然后把不同类型的模块交给对应的loader处理,处理完成后打包到一起。
这个过程的描述有些不清晰:webpack负责构建依赖图,那么实际项目中那么多种不同类型的模块,它们的依赖如何解析?loader负责处理不同类型的模块,处理时候也要解析依赖吗,到底是webpack解析依赖,还是loader解析依赖?loader它到底做了哪些事情?最终webpack是如何将不同模块打包到一起的呢?

其实,webpack本身可以支持几种常见的模块:https://webpack.docschina.org/concepts/modules/#supported-module-types

对于这些类型的模块,webpack会对其根据后缀匹配,然后进行默认方式的解析,不需要配置loader,例如JavaScript/auto,支持ESM、CommonJS、AMD,对于asset类型的模块会输出静态资源然后导出引用地址。

对于其他类型的模块,需要对应的loader处理。
loader主要做了两件事:

  1. 转译代码。
  2. 将模块化代码转为webpack可以识别的格式。例如对于css,@import等引用其他css的语法webpack并不能识别,css-loader会将这些模块引用语法转换为require,这样就能够被webpack识别了。所以,最终负责依赖解析的还是webpack,loader只是将模块转为webpack能识别的模块。loader还有一种方式可以让webpack知道某个模块的依赖,就是使用this.resolve/this.getResolve。(https://webpack.docschina.org/contribute/writing-a-loader/#module-dependencies

webpack打包过程可以图示如下

webpack模块化 - 图1

  1. webpack对原始资源做默认处理。
  2. 交给loader处理,将依赖的语句改成require或者通过this.resolve解析依赖。也就是说loader得负责把模块转成webpack能够识别的模块化语法(包括导入和导出语法),这样webpack才能根据导入语句分析依赖,才能根据导出语句进行包装然后打包。
  3. loader处理完交给webpack,webpack解析依赖,然后递归处理依赖模块。
  4. 添加运行时代码,打包。

模块解析相关配置

1. Rule.type

webpack支持通过设置Rule.type控制模块的默认解析方式:https://webpack.docschina.org/configuration/module/#ruletype

例如前言中提到的第一个问题,我们可以什么都不配置,webpack就会按照默认方式,把json解析成js对象。相当于

  1. export default {
  2. "version": "1.0.0",
  3. "name": "config"
  4. };

如果希望把json作为静态资源解析,则要配置Rule.type

  1. // webpack.config.js
  2. module.exports = {
  3. // other config...
  4. module: {
  5. rules: [
  6. {
  7. test: /\.json$/,
  8. type: 'asset/resource'
  9. }
  10. ]
  11. }
  12. };

如果模块类型(后缀)和配置的type不匹配,webpack会不进行默认处理,而是交给相应的loader处理。

2. module.noParse

顾名思义,用于模块没有依赖的场景,模块不会被webpack进行解析,直接被打包到bundle。
对于那些模块中确定没有其他依赖的js模块,可以不继续进行模块解析。例如大型的、已经打包好的、以global方式引入的第三方库,设置该配置可以避免模块解析工作从而提升构建性能。

  1. module.exports = {
  2. //...
  3. module: {
  4. noParse: /jquery|lodash/,
  5. },
  6. };

3. Rule.exclude

该配置用于模块本身已经经过处理,不需要loader再次处理,可以直接让webpack处理。这个选项也可以用来缩小构建目标。

模块打包

依赖解析完成之后,代码也转译完成后,剩下的就是打包了。

普通模块打包

webpack解析好模块后,会将代码都包装成commonjs格式的模块,本质就是闭包。通过webpack运行时代码完成模块导出导入。

例如有这样的代码

  1. // index.js
  2. import lib from './lib';
  3. console.log(lib);
  4. // lib.js
  5. export default 'lib';

webpack配置

  1. // webpack.config.js
  2. module.exports = {
  3. entry: './src/index.js',
  4. mode: 'development',
  5. };

在development模式下打包结果如下(经过简化)

  1. (() => {
  2. "use strict";
  3. var __webpack_modules__ = ({
  4. "./src/index.js":
  5. ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
  6. __webpack_require__.r(__webpack_exports__);
  7. var _lib__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__("./src/lib.js");
  8. console.log(_lib__WEBPACK_IMPORTED_MODULE_0__["default"]);
  9. }),
  10. "./src/lib.js":
  11. ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
  12. __webpack_require__.r(__webpack_exports__);
  13. __webpack_require__.d(__webpack_exports__, {
  14. "default": () => (__WEBPACK_DEFAULT_EXPORT__)
  15. });
  16. const __WEBPACK_DEFAULT_EXPORT__ = ('lib');
  17. })
  18. });
  19. var __webpack_module_cache__ = {};
  20. function __webpack_require__(moduleId) {
  21. var cachedModule = __webpack_module_cache__[moduleId];
  22. if (cachedModule !== undefined) {
  23. return cachedModule.exports;
  24. }
  25. var module = __webpack_module_cache__[moduleId] = {
  26. exports: {}
  27. };
  28. __webpack_modules__[moduleId](module, module.exports, __webpack_require__);
  29. return module.exports;
  30. }
  31. (() => {
  32. __webpack_require__.d = (exports, definition) => {
  33. for(var key in definition) {
  34. if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {
  35. Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });
  36. }
  37. }
  38. };
  39. })();
  40. (() => {
  41. __webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))
  42. })();
  43. (() => {
  44. __webpack_require__.r = (exports) => {
  45. if(typeof Symbol !== 'undefined' && Symbol.toStringTag) {
  46. Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
  47. }
  48. Object.defineProperty(exports, '__esModule', { value: true });
  49. };
  50. })();
  51. var __webpack_exports__ = __webpack_require__("./src/index.js");
  52. })();

我们对上面打包结果进一步改造,提取关键代码

  1. (() => {
  2. "use strict";
  3. var modules = ({
  4. "./src/index.js":
  5. ((exports, require) => {
  6. var lib = require("./src/lib.js");
  7. console.log(lib["default"]);
  8. }),
  9. "./src/lib.js":
  10. ((exports, require) => {
  11. exports.default = 'lib';
  12. })
  13. });
  14. var modulesCache = {};
  15. function require(moduleId) {
  16. var cachedModule = modulesCache[moduleId];
  17. if (cachedModule !== undefined) {
  18. return cachedModule.exports;
  19. }
  20. var module = modulesCache[moduleId] = {
  21. exports: {}
  22. };
  23. modules[moduleId](module.exports, require);
  24. return module.exports;
  25. }
  26. require("./src/index.js");
  27. })();

可以发现webpack打包其实做了几件事:

  1. 实现了CommonJS规范的require方法,导入的模块缓存起来,如果下次再导入直接返回结果。
  2. 每个模块引用语句都改成了require引用。
  3. 模块被包装成闭包,按照CommonJS格式(module.exports)导出。

关于模块化语法更多细节可以参考这个文章:https://segmentfault.com/a/1190000010349749

动态引入的模块打包

我们看这样的代码

  1. // index.js
  2. import('./lib').then(
  3. res => {
  4. console.log(res);
  5. }
  6. );
  7. // lib.js
  8. export default 'lib';

webpack配置

  1. // webpack.config.js
  2. module.exports = {
  3. entry: './src/index.js',
  4. mode: 'development',
  5. };

上面代码index模块动态引入lib模块,这种打包会生成两个chunk,切片之间通过webpack运行时异步加载。

打包生成main.js和src_lib_js.js,这里只给出提取关键代码并简化后的结果

  1. // main.js
  2. (() => {
  3. var modules = ({
  4. "./src/index.js":
  5. ((exports, require) => {
  6. require.ensureChunk("src_lib_js")
  7. .then(() => {
  8. return require("./src/lib.js");
  9. })
  10. .then(
  11. res => { console.log(res.default); }
  12. );
  13. })
  14. });
  15. var modulesCache = {};
  16. function require(moduleId) {
  17. var cachedModule = modulesCache[moduleId];
  18. if (cachedModule !== undefined) {
  19. return cachedModule.exports;
  20. }
  21. var module = modulesCache[moduleId] = {
  22. exports: {}
  23. };
  24. modules[moduleId](module.exports, require);
  25. return module.exports;
  26. }
  27. var installedChunks = {
  28. "main": 0
  29. };
  30. require.ensureChunk = (chunkId) => {
  31. // 拼接url
  32. function getScriptUrl(chunkId) {
  33. var scriptUrl;
  34. // web worker
  35. if (window.importScripts) scriptUrl = window.location + "";
  36. var document = window.document;
  37. if (!scriptUrl && document) {
  38. if (document.currentScript)
  39. // 以当前的script为基准加载chunk
  40. scriptUrl = document.currentScript.src
  41. if (!scriptUrl) {
  42. var scripts = document.getElementsByTagName("script");
  43. if(scripts.length) scriptUrl = scripts[scripts.length - 1].src
  44. }
  45. }
  46. if (!scriptUrl) throw new Error("Automatic publicPath is not supported in this browser");
  47. // 去掉路由后面的内容(hash、query和多余的斜杠)
  48. scriptUrl = scriptUrl.replace(/#.*$/, "").replace(/\?.*$/, "").replace(/\/[^\/]+$/, "/");
  49. return scriptUrl + chunkId + '.js';
  50. }
  51. // 如果未安装过,则通过script标签下载js文件
  52. if (installedChunks[chunkId] === undefined) {
  53. return new Promise((resolve, reject) => {
  54. var script = document.createElement('script');
  55. script.src = getScriptUrl(chunkId);
  56. document.head.appendChild(script);
  57. script.onload = resolve;
  58. script.onerror = reject;
  59. });
  60. }
  61. return Promise.resolve();
  62. };
  63. var webpackJsonpCallback = (data) => {
  64. var [chunkId, moreModules] = data;
  65. for(moduleId in moreModules) {
  66. modules[moduleId] = moreModules[moduleId];
  67. }
  68. installedChunks[chunkId][0]();
  69. }
  70. var chunkLoadingGlobal = self["webpackChunkwebpackmodule3"] = self["webpackChunkwebpackmodule3"] || [];
  71. chunkLoadingGlobal.forEach(data => {
  72. webpackJsonpCallback(data);
  73. });
  74. var push = chunkLoadingGlobal.push;
  75. chunkLoadingGlobal.push = data => {
  76. push(data);
  77. webpackJsonpCallback(data);
  78. };
  79. require("./src/index.js");
  80. })();
  81. // src_lib_js.js
  82. "use strict";
  83. (self["webpackChunkwebpackmodule3"] = self["webpackChunkwebpackmodule3"] || [])
  84. .push([
  85. 'src_lib_js',
  86. {
  87. "./src/lib.js":
  88. ((exports, require) => {
  89. exports.default = 'lib';
  90. })
  91. }
  92. ]);

下面解释一下webpack对于动态依赖的打包的关键处理。

动态依赖会把依赖的模块单独打包成一个chunk,chunk就是一个文件,一个chunk中包含1个或多个module。

动态依赖语句会被转为一个promise,通过动态创建script标签异步加载chunk。

加载好chunk后,会做几件事情:

  1. 把自己注册到已安装依赖中(webpackChunkwebpackmodule3
  2. 加载chunk中的所有模块
  3. 把加载chunk的promise resolve

加载好chunk后(即promise resolve后),意味着模块也已经加载好,接下来就会通过require加载模块(第9行)。然后就可以正常地使用模块了。

我们看到webpack通过全局变量webpackChunkwebpackmodule3来管理多chunk的加载过程,那如果多个用webpack打包的项目工作在同一个浏览器中,会不会全局变量冲突呢?webpack考虑到了这个问题,支持用户通过output.jsonpFunction选项配置全局变量的名称,这样就可以避免冲突。

多chunk打包

wepback支持分包加载,可以把项目打包成多个chunk,多个chunk的加载和动态依赖类似,也是要通过一个全局变量管理chunk,所以chunk的加载过程都是一样的。

多chunk需要注意一个问题,因为多个chunk是有依赖关系的,如果我们在html中加载chunk的顺序正确,那么执行的顺序和打成一个bundle一样,如果加载顺序和依赖的关系不一致,就需要通过某种机制保证依赖的chunk加载完,再执行模块。

我们看下面代码打包的示例

  1. // index.js
  2. import lib from './lib';
  3. console.log(lib);
  4. // lib.js
  5. export default 'lib';

webpack配置分包

  1. // webpack.config.js
  2. module.exports = {
  3. entry: './src/index.js',
  4. mode: 'development',
  5. optimization: {
  6. splitChunks: {
  7. chunks: 'all',
  8. minSize: 0,
  9. cacheGroups: {
  10. lib: {
  11. test: /lib/,
  12. }
  13. },
  14. },
  15. }
  16. };

打包产物如下(代码经过简化)

  1. // main.js
  2. (() => {
  3. "use strict";
  4. var modules = ({
  5. "./src/index.js":
  6. ((exports, require) => {
  7. var lib = require("./src/lib.js");
  8. console.log(lib["default"]);
  9. })
  10. });
  11. var modulesCache = {};
  12. // The require function
  13. function require(moduleId) {
  14. var cachedModule = modulesCache[moduleId];
  15. if (cachedModule !== undefined) {
  16. return cachedModule.exports;
  17. }
  18. var module = modulesCache[moduleId] = {
  19. exports: {}
  20. };
  21. modules[moduleId](module.exports, require);
  22. return module.exports;
  23. }
  24. var installedChunks = {
  25. "main": 0
  26. };
  27. // 如果依赖的chunk未加载完成,保存在deferred中
  28. var deferred = [];
  29. // 如果依赖的chunk加载完,执行回调
  30. // 否则保存该模块,等待依赖的chunk都加载完后再执行回调
  31. require.Onload = (chunkIds, fn) => {
  32. var result;
  33. deferred.push([chunkIds, fn]);
  34. // 遍历deferred,将每个依赖chunk加载完成的模块执行
  35. for (var i = 0; i < deferred.length; i++) {
  36. var [chunkIds, fn] = deferred[i];
  37. var fulfilled = true;
  38. for (var j = 0; j < chunkIds.length; j++) {
  39. if ((installedChunks[chunkIds[i]] === 0) {
  40. chunkIds.splice(j--, 1);
  41. }
  42. else {
  43. fulfilled = false;
  44. }
  45. }
  46. if(fulfilled) {
  47. deferred.splice(i--, 1)
  48. var r = fn();
  49. if (r !== undefined) result = r;
  50. }
  51. }
  52. return result;
  53. };
  54. var webpackJsonpCallback = (data) => {
  55. var [chunkId, moreModules] = data;
  56. for(moduleId in moreModules) {
  57. modules[moduleId] = moreModules[moduleId];
  58. }
  59. installedChunks[chunkId][0]();
  60. return require.Onload();
  61. }
  62. var chunkLoadingGlobal = self["webpackChunkwebpackmodule3"] = self["webpackChunkwebpackmodule3"] || [];
  63. chunkLoadingGlobal.forEach(data => {
  64. webpackJsonpCallback(data);
  65. });
  66. var push = chunkLoadingGlobal.push;
  67. chunkLoadingGlobal.push = data => {
  68. push(data);
  69. webpackJsonpCallback(data);
  70. };
  71. // startup
  72. require.Onload(["lib-src_lib_js"], () => (require("./src/index.js")));
  73. })();
  74. // lib-src_lib_js.js
  75. (self["webpackChunkwebpackmodule3"] = self["webpackChunkwebpackmodule3"] || []).push([["lib-src_lib_js"],{
  76. "./src/lib.js":
  77. ((exports, require) => {
  78. exports.default = 'lib';
  79. })
  80. }]);

可以看到分片打包之后,不能像只有一个bundle那样直接通过require引用模块,因为依赖的模块所在的chunk可能没有加载完,因此要先通过require.Onload方法确保chunk已经加载完,再去执行当前模块,由于chunk加载完时,chunk内的所有模块都会被加载,因此这时候通过require引用依赖的模块是没有问题的。

require.Onload方法就是把每个模块依赖的chunk和回调都保存起来,并且检查当前所有的模块,如果发现某个模块依赖的chunk都已经加载完,就执行其回调。每当某个chunk加载完,都会调用require.Onload,以便依赖它的模块可以马上执行。

这样,webpack就可以保证分包的chunk在页面加载顺序和依赖顺序不一致时候,也可以正常工作,同步地执行。

模块路径解析

webpack可以解析三种文件路径:绝对路径、相对路径和模块路径,匹配 路径后还会匹配扩展名。

https://www.webpackjs.com/concepts/module-resolution/#webpack-%E4%B8%AD%E7%9A%84%E8%A7%A3%E6%9E%90%E8%A7%84%E5%88%99

下面看如何使用resolve选项控制路径解析。

resolve选项

下面列举几个常用的resolve选项,更多更详细的说明参考官方文档:
https://www.webpackjs.com/configuration/resolve/

resolve.modules

指定webpack模块解析的目录,默认是[‘node_modules’]。webpack会尝试从resolve.module指定的列表中查找模块路径。

resolve.alias

设置路径别名,设置该选项后,让模块引用更简单。

  1. alias: {
  2. "@": path.resolve(__dirname, 'src'),
  3. "~": path.resolve(__dirname, 'src')
  4. }

resolve.extensions

配置扩展名

  1. {
  2. extensions: [".js", ".json"]
  3. }

webpack会对没有扩展名的路径按照extensions依次匹配,所以通常要把常用的文件扩展名放在前面,以减少尝试匹配的次数。

动态路径的打包

对于动态的路径,如import()/require。会打包相应目录下所有文件,然后在代码运行的时候动态拼接起来加载。

因此应该注意不要让路径太过模糊,否则会打包出非常多的chunk,最极端情况是整个路径都是一个变量,这意味着webpack会打包所有模块。