使用 Scope Hoisting

什么是 Scope Hoisting

默认情况下，经过 Webpack 打包后的模块资源会被组织成一个个函数形式，例如：

tip

关于打包产物形态的更多知识，可参考前文《Webpack 原理系列八：产物转译打包逻辑》

// common.js
export default "common";

// index.js
import common from './common';
console.log(common);

上例最终会被打包出形如下面结构的产物：

"./src/common.js":
  ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
     const __WEBPACK_DEFAULT_EXPORT__ = ("common");
     __webpack_require__.d(__webpack_exports__, {
      /* harmony export */
      "default": () => (__WEBPACK_DEFAULT_EXPORT__)
      /* harmony export */
    });
  }),
"./src/index.js":
  ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
      var _common__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__( /*! ./common */ "./src/common.js");
      console.log(_common__WEBPACK_IMPORTED_MODULE_0__)
  })

这种结构存在两个影响到运行性能的问题：

重复的函数模板代码会增大产物体积，消耗更多网络流量
函数的出栈入栈需要创建、销毁作用域空间，影响运行性能

针对这些问题，自 Webpack 3 开始引入 Scope Hoisting 功能，本质上就是将符合条件的多个模块合并到同一个函数空间内，减少函数声明的模板代码与运行时频繁出入栈操作，从而打包出体积更小、运行性能 更好的包。例如上述示例经过 Scope Hoisting 优化后，生成代码：

((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
    ;// CONCATENATED MODULE: ./src/common.js
    /* harmony default export */ const common = ("common");
    
    ;// CONCATENATED MODULE: ./src/index.js
    console.log(common);
})

开启 Scope Hoisting 特性

Webpack 提供了三种方法开启 Scope Hoisting 功能的方法：

开启 Production 模式
使用 optimization.concatenateModules 配置项
直接使用 ModuleConcatenationPlugin 插件

分别对应下述代码：

const ModuleConcatenationPlugin = require('webpack/lib/optimize/ModuleConcatenationPlugin');

module.exports = {
    // 方法1： 将 `mode` 设置为 production，即可开启
    mode: "production",
    // 方法2： 将 `optimization.concatenateModules` 设置为 true
    optimization: {
        concatenateModules: true,
        usedExports: true,
        providedExports: true,
    },
    // 方法3： 直接使用 `ModuleConcatenationPlugin` 插件
    plugins: [new ModuleConcatenationPlugin()]
};

tip

三种方法的作用原理相似，最终都会用到 ModuleConcatenationPlugin 完成模块分析与合并操作，唯一需要注意的是使用 optimization.concatenateModules 时需要将 usedExports、providedExports 同时设置为 true，标记模块的导入导出变量，才能完成合并操作。

模块合并规则

开启 Scope Hoisting 后，Webpack 会将尽可能多的模块合并到同一个函数作用域下，但合并功能一方面依赖于 ESM 静态分析能力；一方面需要确保合并操作不会造成代码冗余。因此开发者需要注意 Scope Hoisting 会在以下场景下失效：

非 ESM 模块
对于 AMD、CMD 一类的模块，由于模块导入导出内容的动态性，Webpack 无法确保模块合并后不会对原有的代码语义产生副作用，导致 Scope Hoisting 失效，例如：
```
// common.js
module.exports = 'common';

// index.js
import common from './common';
```
上例中，由于 common.js 使用 CommonJS 导入模块内容，Scope Hoisting 失效，两个模块无法合并。
这一问题在导入 NPM 包尤其常见，由于大部分框架都会自行打包后再上传到 NPM，并且默认导出的是兼容性更佳的 CommonJS 模块方案，因而无法使用 Scope Hoisting 功能，此时可通过 mainFileds 属性尝试引入框架的 ESM 版本：
```
module.exports = {
  resolve: {
    // 优先使用 jsnext:main 中指向的 ES6 模块化语法的文件
    mainFields: ['jsnext:main', 'browser', 'main']
  },
};
```
模块被多个 Chunk 引用
如果一个模块被多个 Chunk 同时引用，为避免重复打包，Scope Hoisting 同样会失效，例如：
```
// common.js
export default "common"

// async.js
import common from './common';

// index.js 
import common from './common';
import("./async");
```
上例中，入口 index.js 以异步引用方式导入 async.js 模块，同时 async.js 与 index.js 都依赖于 common.js 模块，根据 Chunk 的运行规则， async.js 会被处理为单独的 Chunk ，这就意味着 common.js 模块同时被 index.js 对应的 Initial Chunk 与 async.js 对应的 Async Chunk 引用，此时 Scope Hoisting 失效，common.js 无法被合并入任一 Chunk，而是作为生成为单独的作用域，最终打包结果：
```
"./src/common.js":
(() => {
  var __WEBPACK_DEFAULT_EXPORT__ = ("common");
}),
"./src/index.js":
(() => {
  var _common__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__( /*! ./common */ "./src/common.js");
  __webpack_require__.e( /*! import() */ "src_async_js").then(__webpack_require__.bind(__webpack_require__, /*! ./async */ "./src/async.js"));
}),  
```

tip

上面的代码对应 Initial Chunk 的内容，Async Chunk 被单独打包到另一个文件中。这边 __webpack_require__.e 函数实际上就是实现了 import() 的功能。

使用 Scope Hoisting

什么是 Scope Hoisting​

开启 Scope Hoisting 特性​

模块合并规则​

什么是 Scope Hoisting

开启 Scope Hoisting 特性

模块合并规则