跳到主要内容

常见问题

为什么 ES 模块比 CommonJS 模块更好?

ES 模块是官方标准,是 JavaScript 代码结构的明确未来发展方向,而 CommonJS 模块是一种特殊的兼容型格式,被视为 ES 模块提出之前的一种临时解决方案。ES 模块允许静态分析,可帮助进行优化(如除屑优化和作用域提升),并提供高级功能(如循环引用和实时绑定)。

什么是除屑优化

除屑优化,也即“保留有用代码”,是 Rollup 的一个处理过程,用于消除在给定项目中实际上未使用的代码。它是一种冗余代码消除的形式,但与输出大小相关的其他方法相比,可以更加高效。该名称源自模块的抽象语法树(而不是模块图)。该算法首先标记所有相关语句,然后“摇晃语法树(让枯叶掉落下来)”,删除所有冗余代码。它的思想与“标记-清除垃圾收集算法”类似。尽管此算法与 ES 模块本身并不相关,但这个思想使其更加高效,因为它们允许 Rollup 将所有模块作为一个具有共享绑定的大型抽象语法树进行处理。

如何在 Node.js 中使用 Rollup 和 CommonJS 模块?

Rollup 力求实现 ES 模块的规范,而不是 Node.js、NPM、require() 和 CommonJS 的行为。因此,CommonJS 模块的加载和使用 Node 的模块位置解析逻辑都作为可选插件实现,不包含在 Rollup 核心中。只需 npm install commonjsnode-resolve 插件,然后使用 rollup.config.js 文件启用它们,即可完成设置。如果模块导入 JSON 文件,则还需要 json 插件。

为什么 node-resolve 不是内置功能?

有两个主要原因:

  1. 在设计哲学上,这是因为 Rollup 本质上是一种类似于 Node 和浏览器中本机模块加载器的 polyfill。在浏览器中,import foo from 'foo' 将无法工作,因为浏览器不使用 Node 的解析算法。

  2. 在实际层面上,如果这些问题有一个良好的 API 可以清晰地分离,那么开发软件就会更加容易。Rollup 的核心非常庞大,一切可以阻止其变得更大的东西都是好事。同时,修复错误和添加功能也更容易。通过保持 Rollup 精简,技术债务的潜在风险很小。

请参见 此问题 以获得更详细的解释。

为什么在代码分割时我的入口块中会出现额外的导入?

默认情况下,在创建多个块时,入口块的依赖项导入将作为空导入添加到入口块本身。请看示例:

// 输入
// main.js
import value from './other-entry.js';
console.log(value);

// other-entry.js
import externalValue from 'external';
export default 2 * externalValue;

// 输出
// main.js
import 'external'; // 这个导入已经从 other-entry.js 提升了。
import value from './other-entry.js';
console.log(value);

// other-entry.js
import externalValue from 'external';
var value = 2 * externalValue;
export default value;

这不会影响代码执行顺序或行为,但它将加快代码的加载和解析速度。如果没有这个优化,JavaScript 引擎需要执行以下步骤来运行 main.js

  1. 加载和解析 main.js。最后,将发现对 other-entry.js 的导入。
  2. 加载和解析 other-entry.js。最后,将发现对 external 的导入。
  3. 加载和解析 external
  4. 执行 main.js

通过此优化,JavaScript 引擎将在解析入口模块后发现所有传递依赖关系,避免了瀑布式加载:

  1. 加载和解析 main.js。最后,将发现对 other-entry.jsexternal 的导入。
  2. 加载和解析 other-entry.jsexternal。从 other-entry.js 导入 external 已经被加载和解析。
  3. 执行 main.js

可能存在不需要此优化的情况,在这种情况下,你可以通过 output.hoistTransitiveImports 选项关闭它。当使用 output.preserveModules 选项时,也不会应用此优化。

如何将 polyfill 添加到 Rollup 产物中?

即使 Rollup 在打包时通常会尝试维护精确的模块执行顺序,但在两种情况下,这并不总是成立:代码分割和外部依赖。外部依赖的问题最为明显,可以参考以下 示例

// main.js
import './polyfill.js';
import 'external';
console.log('main');

// polyfill.js
console.log('polyfill');

这里的执行顺序是 polyfill.jsexternalmain.js。现在,当你打包代码时,你将得到以下结果:

import 'external';
console.log('polyfill');
console.log('main');

使用 externalpolyfill.jsmain.js 的执行顺序。这不是由 Rollup 将 import 放在捆绑包顶部引起的问题——无论在文件中的位置如何,import 都会被首先执行。此问题可以通过创建更多的块来解决:如果 polyfill.js 最终位于与 main.js 不同的块中,正确的执行顺序将得以保留。然而,在 Rollup 中还没有自动执行此操作的方法。对于代码分割,情况类似,因为 Rollup 正在尝试创建尽可能少的块,同时确保不执行不需要的代码。

对于大多数代码而言,这不是一个问题,因为 Rollup 可以保证:

如果模块 A 导入模块 B,且没有循环导入,那么模块 B 总是会在模块 A 之前被执行。

但是,这对于 polyfill 来说是一个问题,因为它们通常需要首先执行,同时又通常不希望在每个模块中都放置一个 polyfill 的导入。幸运的是,这并不是必需的:

  1. 如果没有依赖于 polyfill 的外部依赖项,则在每个静态入口点的第一个语句中添加对 polyfill 的导入即可。
  2. 否则,将 polyfill 作为单独的入口或 手动添加的块 也会始终确保它首先被执行。

Rollup 适用于构建库还是应用程序?

Rollup 已经被许多主要的 JavaScript 库使用,并且也可以用于构建绝大多数应用程序。但是,如果你想在旧版浏览器中使用代码拆分或动态导入,则需要使用额外的运行时来处理加载丢失的块。我们建议使用 SystemJS 构建产物作为生产环境,因为它与 Rollup 的系统格式输出很好地集成,并且能够正确处理所有 ES 模块实时绑定和重新导出边缘情况。或者,也可以使用 AMD 加载器。

我如何在浏览器中运行 Rollup?

虽然常规的 Rollup 构建依赖于一些 NodeJS 特性,但还有一个仅使用浏览器 API 的浏览器版本可用。你可以通过以下方式安装它:

npm install @rollup/browser

在你的脚本代码中,这样导入:

import { rollup } from '@rollup/browser';

另外,你也可以从 CDN 导入,例如导入 ESM 格式产物:

import * as rollup from 'https://unpkg.com/@rollup/browser/dist/es/rollup.browser.js';

而对于 UMD 格式产物:

<script src="https://unpkg.com/@rollup/browser/dist/rollup.browser.js"></script>

这将创建一个全局变量 window.rollup。由于浏览器构建无法访问文件系统,因此你需要提供解析和加载要捆绑的所有模块的插件。以下是一个虚构的示例:

/** @type {import('rollup')} */
var rollup;
// ---cut---
const modules = {
'main.js': "import foo from 'foo.js'; console.log(foo);",
'foo.js': 'export default 42;'
};

rollup
.rollup({
input: 'main.js',
plugins: [
{
name: 'loader',
resolveId(source) {
if (modules.hasOwnProperty(source)) {
return source;
}
},
load(id) {
if (modules.hasOwnProperty(id)) {
return modules[id];
}
}
}
]
})
.then(bundle => bundle.generate({ format: 'es' }))
.then(({ output }) => console.log(output[0].code));

此示例仅支持两个导入,"main.js""foo.js",不支持相对导入。以下是另一个示例,它使用绝对 URL 作为入口点,并支持相对导入。在这种情况下,我们只是重新打包 Rollup 本身,但它可以用于任何其他公开 ES 模块的 URL:

/** @type {import('rollup')} */
var rollup;
// ---cut---
rollup
.rollup({
input: 'https://unpkg.com/rollup/dist/es/rollup.js',
plugins: [
{
name: 'url-resolver',
resolveId(source, importer) {
if (source[0] !== '.') {
try {
new URL(source);
// If it is a valid URL, return it
return source;
} catch {
// Otherwise make it external
return { id: source, external: true };
}
}
return new URL(source, importer).href;
},
async load(id) {
const response = await fetch(id);
return response.text();
}
}
]
})
.then(bundle => bundle.generate({ format: 'es' }))
.then(({ output }) => console.log(output));

Rollup logo 是谁制作的?太可爱了!

Julian Lloyd!