写点什么

不要再依赖 CommonJS 了

  • 2020-05-20
  • 本文字数:3491 字

    阅读完需:约 11 分钟

不要再依赖CommonJS了

在这篇文章中,我们将研究什么是 CommonJS,以及为什么它会让你的 JavaScript 包大小过分膨胀。为了确保打包器(bundler)能成功优化你的应用程序大小,请避免依赖 CommonJS 模块,并在整个应用程序中使用 ES2015 模块语法。


本文最初发布于web.dev网站,经原作者 Minko Gechev 授权由 InfoQ 中文站翻译并分享。


什么是 CommonJS?

CommonJS 是 2009 年的标准,为 JavaScript 模块建立了约定。它最初打算在 Web 浏览器之外的场景中使用,主要用于服务端应用程序。


使用 CommonJS,你可以定义模块,从中导出功能,并将它们导入其他模块中。例如,下面的代码片段定义了一个模块,其导出五个函数:add,subtract,multiply,divide 和 max:


// utils.jsconst { maxBy } = require('lodash-es');const fns = {  add: (a, b) => a + b,  subtract: (a, b) => a - b,  multiply: (a, b) => a * b,  divide: (a, b) => a / b,  max: arr => maxBy(arr)};Object.keys(fns).forEach(fnName => module.exports[fnName] = fns[fnName]);
复制代码


稍后,另一个模块可以导入和使用这些函数:


// index.jsconst { add } = require(‘./utils');console.log(add(1, 2));
复制代码


使用 node 调用 index.js 将在控制台中输出数字 3。


由于 2010 年代初期浏览器中缺乏标准化的模块系统,CommonJS 也成为了 JavaScript 客户端库的流行模块格式。


CommonJS 如何影响最终的打包大小?

服务端 JavaScript 应用程序的大小并不像浏览器中那样重要,所以 CommonJS 并没有在设计时考虑到包大小的控制。与此同时,有分析表明 JavaScript 的包体积仍然是拖慢浏览器应用的主要因素之一。


JavaScript 打包器和压缩器(minifier),例如 webpack 和 terser,会执行多种优化措施以减小应用程序的大小。它们在构建时分析你的应用程序,尝试尽可能删掉那些没用到的源代码。


例如,在上面的代码片段中,你的最终打包应该只包括 add 函数,因为这是你从 utils.js 中导入到 index.js 中的唯一符号。


我们使用以下 webpack 配置来构建这个应用:


const path = require('path');module.exports = {  entry: 'index.js',  output: {    filename: 'out.js',    path: path.resolve(__dirname, 'dist'),  },  mode: 'production',};
复制代码


在这里,我们指定了要使用生产模式优化并将 index.js 用作入口点。调用 webpack 之后,如果我们查看输出大小,将看到下面这样的内容:


$ cd dist && ls -lah625K Apr 13 13:04 out.js
复制代码


请注意,这个包的大小为 625KB。看一下输出,我们将找到来自 utils.js 的所有函数,外加来自 lodash 的很多模块。尽管我们在 index.js 中不使用 lodash,但它也被加进了输出,这给我们的生产资产增加了很多额外负担。


现在我们将模块格式更改为 ECMAScript 2015,然后重试。这次,utils.js 将变成如下所示:


export const add = (a, b) => a + b;export const subtract = (a, b) => a - b;export const multiply = (a, b) => a * b;export const divide = (a, b) => a / b;import { maxBy } from 'lodash-es';export const max = arr => maxBy(arr);
复制代码


并且 index.js 将使用 ES2015 模块语法从 utils.js 导入:


import { add } from './utils';console.log(add(1, 2));
复制代码


使用相同的 webpack 配置,我们可以构建应用程序并打开输出文件。现在大小只有 40 字节,输出如下:


(()=>{"use strict";console.log(1+2)})();
复制代码


请注意,最后的打包中并没有包含 utils.js 中我们没有用到的任何函数,而且也没有 lodash 的痕迹!更进一步,terser(webpack 使用的 JavaScript 压缩器)在 console.log 中内联了 add 函数。


你可能会问一个问题,为什么使用 CommonJS 会导致输出包大了接近 16,000 倍?当然,上面这个应用只是一个简单的示例,实际应用中的体积差异可能没那么大,但 CommonJS 也很有可能给你的生产构建增添了很大的负担。


一般情况下,CommonJS 模块难以优化,因为它们比 ES 模块动态得多。为确保打包器和压缩器可以成功优化应用程序,请避免依赖 CommonJS 模块,并在整个应用程序中使用 ES2015 模块语法。


请注意,即使你在 index.js 中使用了 ES2015,但如果你使用的模块是 CommonJS,应用程序的打包大小也会受到影响。


为什么 CommonJS 会让应用程序体积更大?

为了回答这个问题,我们将研究 webpack 中 ModuleConcatenationPlugin 的行为,然后讨论静态可分析性。这个插件将所有模块合并为一个闭包,并能让你的代码在浏览器中执行得更快。我们来看一个例子:


// utils.jsexport const add = (a, b) => a + b;export const subtract = (a, b) => a - b;
复制代码


// index.jsimport { add } from ‘./utils';const subtract = (a, b) => a - b;console.log(add(1, 2));
复制代码


如上所示,我们有一个 ES2015 模块,然后将其导入 index.js 中。我们还定义了一个 subtract 函数。我们可以使用与上面相同的 webpack 配置来构建项目,但是这次我们将禁用最小化:


const path = require('path');module.exports = {  entry: 'index.js',  output: {    filename: 'out.js',    path: path.resolve(__dirname, 'dist'),  },  optimization: {    minimize: false  },  mode: 'production',};
复制代码


看一下生成的输出:


/******/ (() => { // webpackBootstrap/******/   "use strict";// CONCATENATED MODULE: ./utils.js**const add = (a, b) => a + b;const subtract = (a, b) => a - b;// CONCATENATED MODULE: ./index.js**const index_subtract = (a, b) => a - b;**console.log(add(1, 2));**/******/ })();
复制代码


在上面的输出中,所有函数都在同一个命名空间内。为了防止冲突,webpack 将 index.js 中的 subtract 函数重命名为 index_subtract。


如果让一个压缩器处理上面的源代码,它将:


  • 删除未使用的 subtract 和 index_subtract 函数

  • 删除所有注释和多余的空格

  • 在 console.log 调用中内联 add 函数的主体


开发人员通常将这种移除未使用的导入的操作称为摇树优化(tree-shaking)。因为 webpack 能够静态地(在构建时)了解我们从 utils.js 导入及导出的符号,所以它才能实现摇树优化。


ES 模块默认启用此行为,因为与 CommonJS 相比,它们更容易进行静态分析


我们来看完全相同的示例,但是这次将 utils.js 更改为使用 CommonJS 模块:


// utils.jsconst { maxBy } = require('lodash-es');const fns = {  add: (a, b) => a + b,  subtract: (a, b) => a - b,  multiply: (a, b) => a * b,  divide: (a, b) => a / b,  max: arr => maxBy(arr)};Object.keys(fns).forEach(fnName => module.exports[fnName] = fns[fnName]);
复制代码


这个小小的更新会显著影响输出结果。受限于文章篇幅,这里我只分享其中的一小部分:


...(() => {"use strict";/* harmony import */ var _utils__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(288);const subtract = (a, b) => a - b;console.log((0,_utils__WEBPACK_IMPORTED_MODULE_0__/* .add */ .IH)(1, 2));})();
复制代码


请注意,最终的打包包含一些 webpack“运行时”:也就是注入的代码,负责从打包的模块中导入/导出功能。这次,我们不是将 utils.js 和 index.js 中的所有符号放在同一个命名空间下,而是在运行时动态请求使用__webpack_require__的 add 函数。


这是必需的,因为使用 CommonJS,我们可以从任意表达式中获取导出名称。例如,下面的代码是绝对有效的构造:


module.exports[localStorage.getItem(Math.random())] = () => { … };
复制代码


打包器无法在构建时知道导出的符号是什么名称,因为这里需要的信息在用户浏览器的上下文中,而且仅在运行时可用。


这样压缩器无法从 index.js 的依赖项中了解它到底使用了哪些内容,因此无法将无用代码优化。我们还能观察到第三方模块也有完全相同的行为。如果我们从 node_modules 导入 CommonJS 模块,你的构建工具链将无法正确优化它。


基于 CommonJS 实现摇树优化

由于 CommonJS 模块是动态定义的,因此它们分析起来要困难得多。例如,与 CommonJS 相比,ES 模块中的导入位置始终是一个字面量(前者则是一个表达式)。


在某些情况下,如果你使用的库遵循有关 CommonJS 用法的特别约定,则可以在构建时使用这个第三方webpack插件删除未使用的导出。但尽管这个插件增加了对摇树优化的支持,但并未涵盖依赖项使用 CommonJS 的所有可能方式。这意味着你无法获得与 ES 模块相同的保障。此外,除了默认的 webpack 行为外,它还会在构建过程中增加额外的成本。


结论

总之,再次强调,为了确保打包器可以成功优化你的应用程序,请避免依赖 CommonJS 模块,并在整个应用程序中使用 ES2015 模块语法。


原文链接:


https://web.dev/commonjs-larger-bundles/


2020-05-20 08:007333

评论 3 条评论

发布
用户头像
那就不要用webpack啊
2020-05-20 14:28
回复
用户头像
好文章
2020-05-20 13:01
回复
用户头像
infoq 真是个宝藏!
2020-05-20 09:42
回复
没有更多了
发现更多内容

模块五

Only

架构实战营 「架构实战营」

架构训练营 毕业设计

吴霏

架构训练营 「架构实战营」

【微博评论】功能的高性能高可用计算架构设计

红莲疾风

「架构实战营」

设计电商秒杀系统

Steven

架构实战营

为什么您的企业需要移动CRM系统

低代码小观

移动 CRM CRM系统 客户关系管理系统 企业管理工具

当使用Vue2+Babel时,如何实现组件重新渲染

DisonTangor

Vue babel

【架构实战营】模块九作业

liu🍊

hw9-毕业项目设计

WWH

架构实战营

zip文件自动打包

你?

低代码实现探索(二十)功能的路径

零道云-混合式低代码平台

Go 语言快速入门指南:Go 指针

宇宙之一粟

指针 Go 语言 1月月更

记中山公园全马--一场无准备的马

wood

跑步 300天创作

一条 Git 命令减少了一般存储空间,我的服务器在偷着笑

沉默王二

云原生训练营 毕业总结

张大彪

云原生

电商秒杀系统设计

天天向上

架构实战营

5Why根因分析法:通过好问题引出一个好答案

石云升

1月月更 分析方法

低代码实现探索(二十一)微流动作返回值类型

零道云-混合式低代码平台

ReactNative进阶(十九):React Native 按钮 Touchable 系列组件使用详解

No Silver Bullet

​React Native 1月月更 Touchable

设计电商秒杀系统

Mars

架构实战营 「架构实战营」

Hoo虎符研究院 | 投资前沿——过去一周顶级投资机构动向

区块链前沿News

虎符 Hoo 虎符交易所 区块链投资

架构实战营-毕业设计

瓜子葫芦侠

「架构实战营」

毕业设计

Geek_cb2b43

一文带你快速了解 Java 线上问题快速诊断神器 Arthas

zuozewei

性能测试 Java性能 性能分析 Arthas 1月月更

不要再依赖CommonJS了_语言 & 开发_Minko Gechev_InfoQ精选文章