写点什么

不要再依赖 CommonJS 了

2020 年 5 月 20 日

不要再依赖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 年 5 月 20 日 08:006664

评论 3 条评论

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

HTML5 && CSS

shirley

html5 css3

ARTS - Week 2

Khirye

ARTS 打卡计划 arts

不到100行代码的iOS组件化你怕了么?

毒手疯波

ios 组件化 url scheme scheme

使用Nginx防止IP地址被恶意解析

Noneplus

nginx 恶意解析

大数据中台之Kafka,到底好在哪里?

奈学教育

kafka

使用ADMT和PES实现window AD账户跨域迁移-介绍篇

Young先生

windows AD ADMT PES 迁移

分布式事务 - 分布式事务框架Seata

Java收录阁

分布式事务

别再说你不懂Linux内存管理了,10张图给你安排的明明白白

柠檬橙

Linux 后台开发

ARTS-week1

书生

别做误人子弟的「职业导师」

Tony Wu

职业成长 导师 教练

预告|2020中国CRM品牌测评报告

人称T客

【写作群星榜】5.29~6.4写作平台优秀作者&文章排名

InfoQ写作平台官方

写作平台 排行榜

白话说流——什么是流,从批认识流(一)

KAMI

大数据 flink 流计算

如果我能找到工作,那么你也行

escray

python3.8.3安装ipython和jupyter

LinkPwd

python3.x Jupyter Notebook

5G时代,如何彻底搞定海量数据库的设计与实践

奈学教育

海量数据库的设计与实践

六处提及区块链!海南自贸港区块链产业应用先行,与“币”划清界限

CECBC区块链专委会

区块链技术 海南方案 严控 产业

初识软件架构

陈皮

Architecture Architect

TCP 半连接队列和全连接队列满了会发生什么?又该如何应对?

小林coding

Linux TCP 网络安全 计算机网络 网络协议

我是一个连地摊都不会摆的废人

Neco.W

创业 投机 投机者 地摊

极客大学架构师训练营 听课总结 -- 第一课

John(易筋)

极客时间 架构 极客大学 架构师 极客大学架构师训练营

2020.06.04,我在《架构师训练营》的学习历程:架构方法

罗祥

极客大学架构师训练营

不同层次格局的差异

kimmking

C++:两百字三段代码解决函数返回局部变量问题

韩小非

c++ 函数栈调用 返回局部变量

Silicon Labs Gecko bootloader 简介

taox

zigbee bootlaoder

自学技术看这些网站就够了!

我是程序员小贱

学习

万字总结——反射(框架之魂)

学习Java的小姐姐

Java 反射 Java 25 周年

NIO 看破也说破(五): 搞,今天就搞,搞懂Buffer

小眼睛聊技术

Java 学习 读书笔记 架构 后端

原创 | TDD工具集:JUnit、AssertJ和Mockito (十七)编写测试-标签和过滤

编程道与术

Java 编程 TDD 单元测试 JUnit

地摊经济一千年:从《韩熙载夜宴图》到木屋烧烤“撸串”

夜来妖

产品经理 商业 新闻动态 新基建 地摊

我的编程之路 -7(T型人才)

顿晓

T型人才 编程之路

NLP领域的2020年大事记及2021展望

NLP领域的2020年大事记及2021展望

不要再依赖CommonJS了-InfoQ