该选项用于匹配需要排除在 bundle 外部的模块，它的值可以是一个接收模块 id 参数并返回 true （表示外部依赖）或 false （表示非外部依赖）的函数，也可以是一个模块 ID 数组或者正则表达式。除此之外，它还可以只是单个的模块 ID 或正则表达式。被匹配的模块 ID 应该满足以下条件之一：

请注意，如果要通过 /node_modules/ 正则表达式过滤掉包的引入，例如 import {rollup} from 'rollup'，需要先使用类似 @rollup/plugin-node-resolve 的插件，来将引入依赖解析到 node_modules。

当用作命令行参数时，该选项的值应该是一个以逗号分隔的模块 ID 列表：

当该选项的值为函数时，它提供了三个参数 (id, parent, isResolved)，可以为你提供更细粒度的控制：

当创建 iife 或 umd 格式的 bundle 时，你需要通过 output.globals 选项提供全局变量名，以替换掉外部引入。

如果一个相对引入，即以 ./ 或 ../ 开头，被标记为 external，rollup 将在内部将该模块 ID 解析为绝对路径，以便引入的不同外部模块可以合并。当写入生成的 bundle 后，这些引入模块将再次被转换为相对引入。例如：

如果存在多个入口，rollup 会转换回相对引入的方式，就像 output.file 或 output.dir 与入口文件或所有入口文件位于相同目录。

该选项用于指定 bundle 的入口文件（例如，你的 main.js，app.js 或 index.js 文件）。如果值为一个入口文件的数组或一个将名称映射到入口文件的对象，那么它们将被打包到单独的输出 chunks。除非使用 output.file 选项，否则生成的 chunk 名称将遵循 output.entryFileNames 选项设置。当该选项的值为对象形式时，对象的属性名将作为文件名中的 [name]，而对于值为数组形式，数组的值将作为入口文件名。

请注意，当选项的值使用对象形式时，可以通过在名称中添加 / 来将入口文件放入不同的子文件夹。以下例子将根据 entry-a.js 和 entry-b/index.js，产生至少两个入口 chunks，即 index.js文件将输出在 entry-b 文件夹中：

如果你想将一组文件转换为另一种格式，并同时保持文件结构和导出签名，推荐的方法是将每个文件变成一个入口文件，而不是使用 output.preserveModules，后者可能会导出被除屑优化，并产生由插件创建的虚拟文件。你可以动态地处理，例如通过 glob 包。

如果某些插件在 buildStart 钩子结束前至少生成了一个 chunk（使用 this.emitFile），则该选项可以省略。

当使用命令行时，多个入口只需要多次使用该选项输入。当作为第一个选项提供时，相当于不以 --input 为前缀：

可以使用 = 赋值来命名 chunk：

可以使用引号指定包含空格的文件名：

该选项用于指定所有生成的 chunk 被放置在哪个目录中。如果生成一个以上的 chunk，那么这个选项是必需的。否则，可以使用 file 选项来代替。

该选项用于指定要写入的文件。如果适用的话，也可以用于生成 sourcemap。只有在生成的 chunk 不超过一个的情况下才可以使用。

该选项用于指定生成的 bundle 的格式。满足以下其中之一：

该选项用于在 umd / iife bundle 中，使用 id: variableName 键值对指定外部依赖。例如，在这样的情况下：

我们需要告诉 Rollup jquery 是外部依赖，jquery 模块的 ID 为全局变量 $：

或者，可以提供一个函数，将外部模块的 ID 变成一个全局变量名。

当作为命令行参数时，该选项的值应该是以逗号分隔的 id:variableName 键值对列表：

要告诉 Rollup 用全局变量替换本地文件时，请使用一个绝对路径的 ID。

对于输出格式为 iife / umd 的 bundle 来说，若想要使用全局变量名来表示你的 bundle 时，该选项是必要的。同一页面上的其他脚本可以使用这个变量名来访问你的 bundle 输出。

该选项也支持命名空间，即可以包含点 . 的名字。最终生成的 bundle 将包含命名空间所需要的设置。

该选项用于指定输出插件。关于如何使用特定输出的插件，请查看 使用输出插件，关于如何编写自己的插件，请查看 插件。对于从包中引入的插件，记得要调用引入的插件函数（即调用 commonjs()，而不仅仅是 commonjs）。返回值为假的插件将被忽略，这样可以用来灵活启用或禁用插件。嵌套的插件将扁平化。异步插件将等待和被解决。

并非所有的插件都可以通过该选项使用。output.plugins 仅限于在 bundle.generate() 或 bundle.write() 阶段，即在 Rollup 的主要分析完成后运行钩子的插件才可使用。如果你是一个插件作者，请查看 输出生成钩子 章节以了解哪些钩子可以使用。

以下是一个使用压缩插件作用于其中一个输出的例子：

关于如何使用插件的更多信息，请查看 使用插件章节，关于如何编写你自己的插件，请查看 插件章节（试试看吧，它并不像听起来那么困难，你可以通过 Rollup 插件做很多拓展）。对于从包中引入的插件，记住要调用引入的插件函数（即调用 commonjs()，而不仅仅是 commonjs）。返回值为假的插件将被忽略，这样可以用来灵活启用或禁用插件。嵌套的插件将扁平化。异步插件将等待和被解决。

（上述例子还演示了如何使用一个异步 IIFE 和动态引入来避免引入不必要的模块，这可能会使打包过程变慢。）

该选项用于指定之前 bundle 的 cache 属性。使用该设置，Rollup 将只会对改变的模块重新分析，从而加速观察模式中后续的构建。将此选项明确设置为 false 将阻止 bundle 生成 cache 属性，也将导致插件的缓存失效。

该选项决定哪些日志将被处理。查看 onLog 以了解可用的日志级别。默认的 logLevel 为 "info"，这意味着 info 和 warning 日志将被处理，而 debug 日志将被忽略，这意味着它们既不会传递给插件 onLog 钩子，也不会传递给 onLog 选项或打印到控制台。

当使用命令行时，错误日志仍将打印到控制台，因为它们不会通过日志系统处理。查看 --silent 标志以了解如何抑制错误日志。

该选项决定外部依赖的绝对路径是否应该在输出中转换为相对路径。本选项不仅适用于源文件中的绝对路径，也适用于由插件或 Rollup 核心解析出的绝对路径。

值为 true 时，像 import "/Users/Rollup/project/relative.js" 这样的外部引入将被转换为相对路径。当把绝对路径转换为相对路径时，Rollup 不考虑 file 或 dir 选项，因为这些选项可能不存在，比如在使用 JavaScript API 的构建中。相反，它假设输出 bundle 的根目录位于 bundle 中包含的所有模块的同一父目录。比如说所有模块的公共父目录是 "/Users/Rollup/project"，上面的引入可能会在输出中被转换为 import "./relative.js"。如果输出 chunk 本身是嵌套在一个子目录中，通过设置例如 chunkFileNames: "chunks/[name].js"，那么引入将会转换为 "../relative.js"。

如上所述，这也适用于最初的相对引入，如 import "./relative.js"，在被 external 选项标记为外部依赖之前会被解析为绝对路径。

一个常见的问题是，这种机制也会适用于像 import "/absolute.js'" 这样的引入，导致输出中出现意外的相对路径。

对于这种情况，设置为 "ifRelativeSource" 可以检查原始引入是否是相对引入，然后在输出时才将其转换为相对引入。设置为 false 将在输出时保持所有路径为绝对路径。

请注意，当一个相对路径使用 external 选项直接标记为 "外部依赖" 时，那么它在输出时会是相同的相对路径。当它通过插件或 Rollup 核心解析，然后标记为外部依赖后，上述逻辑将适用。

该选项限制 rollup 在读取模块或写入 chunk 时，同时能打开的文件数量。如果没有限制或者数值足够高，构建可能会失败，显示“EMFILE: Too many open files”（EMFILE：打开的文件数过多）。这取决于操作系统限制的句柄数（open file handles）大小。

一个用于截取日志信息的函数。如果未提供，日志将打印到控制台，其中 Rollup CLI 会聚合某些 "warn" 日志，并在构建完成后打印汇总的警告，以减少干扰。当使用 --silent 命令行选项时，也会触发此处理程序。

该函数接收三个参数：日志级别、日志对象和默认处理程序。日志对象至少有一个 code 和一个 message 属性，允许你控制如何处理不同类型的日志。其他属性根据日志类型添加。参见 utils/logs.ts，查看内置错误和日志的完整列表，以及它们的代码和属性。

如果不调用默认处理程序，日志将不会打印到控制台。此外，您可以通过调用不同级别的默认处理程序来改变日志级别。使用附加级别 "error" 将把日志转换为一个抛出的错误，该错误具有附加的所有日志属性。

这个处理程序不会在日志被 logLevel 选项过滤掉时被调用。例如，默认情况下，"debug" 日志将被忽略。

一些日志也有 loc 和 frame 属性，允许你定位日志的源：

一个函数，用于拦截警告信息。它与 onLog 非常相似，但只接收警告。如果调用默认处理程序，日志将被处理为警告。如果提供了 onLog 和 onwarn 处理程序，只有当 onLog 调用其默认处理程序时，onwarn 处理程序才会被调用，且 level 为 warn。

查看 onLog 了解更多信息

该选项的值是一个匹配模式，用于自定义构建结果中的静态资源名称，或者值为一个函数，对每个资源调用以返回匹配模式。这种模式支持以下的占位符：

正斜杠 / 可以用来划分文件到子目录。当值为函数时，assetInfo 是 generateBundle 中没有 fileName 的简化版本。另见output.chunkFileNames，output.entryFileNames。

该选项用于在 bundle 前或后添加一个字符串。其值也可以是一个返回 string 的 Promise 异步函数（注意：banner 和 footer 选项不会破坏 sourcemaps）。

如果该选项值为函数，参数 chunk 包含了额外信息，使用了与 generateBundle 钩子相同的 ChunkInfo 类型，但有以下区别：

chunk 是可变的，在这个钩子中应用的变化将传递到其他插件和生成的 bundle 中。这意味着如果你在这个钩子中增加或删除引入或导出，你应该更新 imports、importedBindings 以及 exports。

另见 output.intro/output.outro。

该选项用于对代码分割中产生的 chunk 自定义命名，其值也可以是一个函数，对每个 chunk 调用以返回匹配模式。这种模式支持以下的占位符：

正斜杠 / 可以用来划分文件到子目录。当值为函数时，chunkInfo 是 generateBundle 的简化版本，其中不包含依赖于文件名的属性，且没有关于所渲染模块的信息，因为只有在文件名生成之后才会渲染。另见 output.assetFileNames，output.entryFileNames。

该选项用于压缩 Rollup 产生的额外代码。请注意，这个选项不会影响用户的代码。这个选项在构建已经压缩好的代码时是很有用的。

虽然 CommonJS 输出最初只支持 require(…) 语法来引入依赖，但最近的 Node 版本也开始支持 import(…) 语法，这是从 CommonJS 文件中引入 ES 模块的唯一方法。如果这个选项默认值为 true，表示 Rollup 会在 CommonJS 输出中保持外部依赖以 import(…) 表达式动态引入。将值设置为 false，以使用 require(…) 语法重写动态引入。

该选项用于指定 chunks 的入口文件模式，其值也可以是一个函数，对每个入口 chunk 调用以返回匹配模式。这种模式支持以下的占位符：

正斜杠 / 可以用来划分文件到子目录。当值为函数时，chunkInfo 是 generateBundle 的简化版本，其中不包含依赖于文件名的属性，且没有关于所渲染模块的信息，因为只有在文件名生成之后才会渲染。但是，你可以访问包含 moduleIds 的列表。另见 output.assetFileNames，output.chunkFileNames。

在设置 output.preserveModules 选项时，该模式也会生效。需要注意在这种情况下，[name] 将包括来自输出根路径的相对路径以及可能有原始文件的扩展名，如果它不是 .js、.jsx、.mjs、.cjs、.ts、.tsx、.mts 或 .cts 的其中之一。

该选项用于指定是否扩展 umd 或 iife 格式中 name 选项定义的全局变量。当值为 true 时，该全局变量将定义为 (global.name = global.name || {})。当值为 false 时，name 选项指定的全局变量将被覆盖为 (global.name = {})。

是否在输出中为外部引入添加导入属性，如果输出格式为 es。默认情况下，属性来自输入文件，但插件可以稍后添加或删除属性。例如，import "foo" assert {type: "json"} 将导致相同的导入出现在输出中，除非将该选项设置为 false。请注意，模块的所有导入都需要具有一致的属性，否则会发出警告。

该选项用于制定 Rollup 可以在生成的代码中安全地使用哪些语言特性。这不会转译任何用户的代码，而只改变 Rollup 在包装器和辅助函数中使用的代码。你可以从几个预设中选择一个：

该选项表示是否为自动生成的代码片段使用箭头函数。请注意，在某些地方，比如模块封装器，Rollup 会继续生成用小括号封装的常规函数，因为在一些 JavaScript 引擎中，这些函数会提供 明显更好的性能。

该选项表示在某些地方和辅助函数中使用 const 而不是 var。由于代码块的作用域，会使 Rollup 产生更有效的辅助函数。

该选项表示当属性名称与值匹配时，是否允许在对象中使用别名。

该选项可以选择上面列出的预设之一，同时覆盖一些选项。

该选项确定像 default 这样的预留词，是否可以在不加引号的情况下作为属性名。这将使生成的代码语法符合 ES3 标准。但是请注意，为了完全符合 ES3 标准，你可能还需要对一些内置函数进行补丁（polyfill），比如 Object.keys 或 Array.prototype.forEach。

该选项确定是否允许在自动生成的代码片断中使用 Symbol。目前，该选项只控制命名空间是否将 Symbol.toStringTag 属性设置为正确的 Module 值，这意味着对于一个命名空间来说，String(namespace) 打印为 [object Module]。该值又被用于某些库和框架的特征检测。

这个选项决定了 Rollup 在生成文件哈希时可以使用的字符集。

默认情况下，创建多个 chunk 时，入口 chunk 的可传递引入将以空引入的形式被打包。详细信息和背景请查看 "Why do additional imports turn up in my entry chunks when code-splitting?"。该选项的值为 false 将禁用此行为。当使用 output.preserveModules 选项时，该选项会被忽略，使得永远不会取消引入。

该选项决定 Rollup 用于导入属性的关键词集合。

该选项用于内联动态引入，而不是用于创建包含新 chunk 的独立 bundle。该选项只在单一输入源时发挥作用。请注意，它会影响执行顺序：如果该模块是内联动态引入，那么它将会被立即执行。

该选项用于控制 Rollup 如何处理默认值，命名空间和动态引入像 CommonJS 这样并不支持这些概念的外部依赖格式。请注意，"default" 的默认模式是模仿 NodeJS 的行为，与 TypeScript 的 esModuleInterop 不同。要获得像 TypeScript 中的行为，需要明确地设置该值为 "auto"。在例子中，我们将使用 CommonJS 格式，但该互操作（interop）的选择也同样适用于 AMD、IIFE 和 UMD 目标。

为了理解不同的取值，我们假设打包以下代码为 cjs：

请记住，对于 Rollup 来说，import * as ext_namespace from 'external'; console.log(ext_namespace.bar); 完全等同于 import {bar} from 'external'; console.log(bar);，并且会打包出同样的代码。然而，在上面的例子中，命名空间对象本身也被传递给一个全局函数，这意味着我们需要它组成一个正确的对象。

"default" 意为所需的值应该被视为引入模块的默认出口，就像在 NodeJS 中从 ES 模块上下文引入 CommonJS 一样。其也支持命名的引入，它们被视为默认引入的属性。为了创建命名空间对象，Rollup 注入了这些辅助函数：

"esModule" 意为 ES 模块转译为所需模块，其中所需的值对应模块的命名空间，而默认的导出是导出对象的 .default 属性。这是唯一不会注入任何辅助函数的互操作类型：

当使用 esModule 时，Rollup 不添加额外的辅助函数，并且对默认出口也支持实时绑定。

"auto" 结合了 "esModule" 和 "default"，通过注入辅助函数，其包含在运行时检测所需的值是否包含 __esModule 属性 的代码。添加这个属性是 TypeScript esModuleInterop、Babel 和其他工具实现的一种解决方式，标志着所需值是 ES 模块编译后的命名空间：

注意 Rollup 是如何重复使用创建的命名空间对象来获得 default 导出的。如果不需要命名空间对象，Rollup 将使用一个更简单的辅助函数：

compat 等同于 "auto"，只是它对默认导出使用了一个稍微不同的辅助函数，其检查是否存在一个 default 属性而不是 __esModule 属性。除了 CommonJS 模块导出的属性 "default" 不应该是默认导出的这种罕见情况，该值通常有助于使互操作“正常工作”，因为它不依赖于特异的实现，而是使用鸭子类型（duck-typing）：

与 "auto" 类似，如果不需要命名空间，Rollup 将使用一个更简单的辅助函数：

"defaultOnly" 与 "default" 类似，但有以下几点区别：

下面示例代码展示了 Rollup 产生的内容。注意，我们从代码中删除了 external.bar，否则，Rollup 会抛出一个错误，因为如上所述，这等同于一个命名引入。

当值为一个函数时，Rollup 将把每个外部依赖 id 传递给这个函数，以控制每个依赖关系的互操作类型。

例如，如果所有的依赖都是 CommonJs，下面的配置将确保只允许从 Node 内置的命名引入：

有一些额外的选项对生成互操作的代码有影响：

除了在特定格式中代码不同外，该选项功能和 output.banner/output.footer 类似。

该选项允许你创建自定义的公共 chunk。当值为对象形式时，每个属性代表一个 chunk，其中包含列出的模块及其所有依赖，除非他们已经在其他 chunk 中，否则将会是模块图（module graph）的一部分。chunk 的名称由对象属性的键决定。

请注意，列出的模块本身不一定是模块图的一部分，该特性对于使用 @rollup/plugin-node-resolve 包并从中使用深度引用（deep imports）是非常有用的。例如：

上述例子中，即使你只是使用 import get from 'lodash/get' 形式引入，Rollup 也会将 lodash 的所有模块放到一个自定义 chunk 中。

当该选项值为函数形式时，每个被解析的模块都会经过该函数处理。如果函数返回字符串，那么该模块及其所有依赖将被添加到以返回字符串命名的自定义 chunk 中。例如，以下例子会创建一个命名为 vendor 的 chunk，它包含所有在 node_modules 中的依赖：

请注意，如果自定义 chunk 在使用相应模块之前触发了副作用，那么它可能改变整个应用的行为。

当 manualChunks 值为函数形式时，它的第二个参数是一个对象，包含 getModuleInfo 函数和 getModuleIds 函数，其工作方式与插件上下文中的 this.getModuleInfo 和 this.getModuleIds 相同。

该选项可以用于根据模块在模块图中的位置动态确定它应该被放在哪个自定义 chunk 中。例如，考虑有这样一个场景，有一组组件，每个组件动态引入一组已转译的依赖，即：

如果有很多这样的组件一起使用，则会导致生成许多很小的动态引入 chunk：尽管我们知道由同一 chunk 引入的所有相同语言的语言文件将始终一起使用，但是 Rollup 并不知道。

下面代码将会合并所有仅由单个入口使用的相一语言文件：

默认情况下，在 es、system 格式下或者 output.compact 值为 true 的情况下该选项值为 true，这意味着 Rollup 会尝试把内部变量导出为单个字母的变量，以便更好地压缩代码。

示例 输入：

output.minifyInternalExports: true 时，输出为：

output.minifyInternalExports: false 时，输出为：

该选项值为 true 时，尽管表面上会导致代码输出变大，但实际上，如果你使用了压缩工具，代码输出会更小。在这种情况下，export { importantValue as i } 理论上会被压缩成，比如 export{a as i}，甚至是 export{i}，但实际上输出的是 export{ a as importantValue }，因为压缩工具通常不会改变导出签名。

该选项用于将外部依赖 ID 映射为路径。其中，外部依赖 ID 是指该选项 无法解析 的模块或者通过 external 选项明确指定的模块。output.paths 提供的路径会取代模块 ID，在生成的 bundle 中使用，比如你可以从 CDN 中加载依赖：

该选项将使用原始模块名作为文件名，为所有模块创建单独的 chunk，而不是创建尽可能少的 chunk。它需要配合 output.dir 选项一起使用。除屑优化（Tree-shaking）仍会对没有被入口使用或者执行阶段没有副作用的文件生效，并删除不属于入口起点的未使用文件的导出。另一方面，如果插件（如 @rollup/plugin-commonjs）为实现某些结果而产生了额外的“虚拟”文件，这些文件将作为实际文件使用 _virtual/fileName.js 模式产生。

因此，如果你直接想从这些文件中引入，不建议盲目地使用这个选项将整个文件结构转换为另一种格式，因为预期的输出可能会丢失。在这种情况下，你应该把所有文件明确指定为入口，把它们添加到 input 选项对象 中，可以查看那里的例子。

请注意，在转换为 cjs 或 amd 格式时，设置 output.exports 的值为 auto 可以默认把每个文件作为入口点。这意味着，例如对于 cjs，只包含默认导出的文件将会渲染为：

直接将值赋值给 module.exports。如果有人引入此文件，他们可以通过以下方式访问默认导出

与常规入口点一样，混合使用默认导出和命名导出的模块将会产生警告。你可以通过设置 output.exports: "named"，强制所有文件使用命名导出模式来避免出现警告。在这种情况下，可以通过导出的 .default 属性访问默认导出：

当 output.preserveModules 值为 true 时，输入模块的目录路径应从 output.dir 路径中剥离出来。

例如，给定以下配置：

preserveModulesRoot 设置确保输入的模块会输出到 dist/module.js 和 dist/another/module.js 路径。

在使用 @rollup/plugin-node-resolve 等插件时，这个选项特别有用，它可能导致输出目录结构的变化。当第三方模块没有标记为 external 时，或者在 monorepo 中多个包相互依赖时，没有标记为 external，都可能发生这种情况。

如果该选项值为 true，那么将生成一个独立的 sourcemap 文件。如果值为 "inline"，那么 sourcemap 会以 data URI 的形式附加到 output 文件末尾。如果值为 "hidden"，那么它的表现和 true 相同，除了 bundle 文件中将没有 sourcemap 的注释。

默认情况下，Rollup 生成的 sourcemap 使用相对 URL 路径来引用它们描述的文件。该选项可提供一个绝对基础 URL 路径，例如 https://example.com，sourcemap 将使用绝对 URL 路径来代替。

如果该选项的值为 true，那么实际源代码将不会被添加到 sourcemap 文件中，从而使其变得更小。

该选项用于指定生成 sourcemap 文件的位置。如果是一个绝对路径，那么 sourcemap 文件中的所有 sources 文件路径都相对于该路径。map.file 属性是 sourcemapFile 的基本名称，因为 sourcemap 文件一般是和其构建后的 bundle 处于同一目录。

如果 output 设置了值，那么 sourcemapFile 不是必须的，这种情况下，它的值会通过输出文件名中添加“.map”推断出来。

该选项指定 sourcemap 的模式，或者是一个根据每个 sourcemap 调用以返回此类模式的函数。该模式支持以下占位符：

正斜杠 / 可以用来将文件放在子目录中。当使用函数时，chunkInfo 是 generateBundle 中的简化版本，不包含依赖于文件名的属性，也没有关于渲染模块的信息，因为渲染只在生成文件名之后发生。但是，你可以访问其中的 moduleIds 列表。另请参见 output.assetFileNames，output.chunkFileNames。

该选项决定是否忽略 sourcemap 中列出的源文件，用于填充 x_google_ignoreList source map 扩展。relativeSourcePath 是生成的 .map 文件到相应源文件的相对路径，而 sourcemapPath 是生成的 sourcemap 文件的绝对路径。

当没有明确指定这个选项时，默认情况下它会把所有路径中带有 node_modules 的文件放在忽略列表中。你可以设置值为 false 来完全关闭忽略列表。

该选项用于 sourcemap 的路径转换。其中，relativeSourcePath 是指从生成的 .map 文件到相对应的源文件的相对路径，而 sourcemapPath 是指生成 sourcemap 文件的绝对路径。

该选项用于重新解析每个生成的 chunk，以检测生成的代码是否是有效的 JavaScript 代码。这对于调试使用 renderChunk 钩子转换代码的插件所产生的输出时很有用。

如果代码是无效的，将抛出警告。请注意，如果没有错误被抛出，你就可以检查输出代码。要把这个警告提升为错误，你可以在 onwarn 中查询。

该选项用于控制 Rollup 尝试确保入口 chunk 与基础入口模块具有相同的导出。

示例 输入：

preserveEntrySignatures: "strict" 时的输出：

preserveEntrySignatures: "allow-extension" 时的输出：

preserveEntrySignatures: false 时的输出：

目前，为独立的入口 chunks 覆盖此设置的唯一方法，是使用插件 API 并通过 this.emitFile 触发这些 chunks，而不是使用 input 选项。

启用此选项后，当使用废弃的功能时，Rollup 将抛出错误而不是警告。此外，如果使用了在下一个主版本（major version）被标记为废弃警告的功能时，也会抛出错误。

该选项用于让插件作者等人能尽早地为即将发布的主要版本调整其插件配置。

除非你知道自己在做什么，否则尽量别使用这些选项！

默认情况下，模块的上下文（即，全局 this）为 undefined。在极少数情况下，你可能需要将其修改为其他名称，比如 window。

与 context 相同，但每个模块要么是由 id: context 键值对构成的对象，要么是 id => context 的函数。

注意，id 仅适用于单文件构建，并且不能与 autoId 或 basePath 结合使用。

该选项用于设置 AMD/UMD bundle 的 ID：

该选项用于设置 chunk ID 的 ID（去除“.js”扩展名后）。

该选项用于设置预生成的 ID 前缀路径。如果构建产物将放置在另一个 AMD 项目中，而不是在根目录中，那么这个设置是有用的。

只在 output.amd.autoId 下生效。

该选项用于指定代替 define 的函数名称：

该选项决定为生成的 chunk 和本地 AMD 模块的引入添加 .js 扩展名：

该选项用于决定是否在生成非 ES 格式导出时添加 __esModule: true 属性。此属性表示导出的值是 ES 模块的命名空间，并且此模块的默认导出对应于导出对象的 .default 属性。

可以查看 output.interop 选项。

该选项用于指定导出模式。默认是 auto，指根据 input 模块导出推测你的意图：

由于这只是一个输出的转换过程，因此仅当默认导出是所有入口 chunk 的唯一导出时，你才能选择 default。同样地，仅当没有导出时，才能选择 none，否则 Rollup 将会抛出错误。

default 和 named 之间的差异会影响其他人使用你的 bundle 的方式。例如，如果该选项的值为 default 时，那么 CommonJS 用户可以通过以下方式使用你的库，例如：

如果该选项的值是 named，那么用户则通过以下方式使用你的库：

问题是，如果你使用 named 导出，但 也 会有一个 default 导出，用户将不得不类似这样做来使用默认导出：

请注意：一些工具，如 Babel、TypeScript、Webpack 和 @rollup/plugin-commonjs，它们能够解析 CommonJS 的 require(...) 调用，并将其转换为 ES 模块。如果你正在生成想要在与这些工具的 ESM 输出可互换的 CommonJS 输出，则应始终使用 named 导出模式。原因是这些工具中大多数默认情况下会在 require 中返回 ES 模块的命名空间，其中默认导出是 .default 属性。

换句话说，对于这些工具，你无法创建一个包接口，在该接口中 const lib = require("your-lib") 能够产生与 import lib from "your-lib" 相同的结果。但是，使用 named 导出模式，const {lib} = require("your-lib") 将与 import {lib} from "your-lib" 等效。

当该选项的值为 false 时，Rollup 不会为外部依赖生成支持动态绑定的代码，而是假定外部依赖永远不会改变。这使得 Rollup 会生成更多优化代码。请注意，当外部依赖存在循环引用时，该选项值为 false 可能会引起问题。

在大多数情况下，该选项值为 false 将避免 Rollup 生成多余代码的 getters，因此在很多情况下，可以使代码兼容 IE8。

例如：

该选项用于决定是否使用 Object.freeze() 冻结动态访问的引入对象的命名空间（例如 import * as namespaceImportObject from...）。

该选项用于指定代码缩进的缩进字符串（在 amd，iife，umd 和 system 格式中）。它的值可以是 false （没有缩进）或 true （默认值——自动缩进）。

该选项决定在 UMD bundle 中生成一个额外的 noConflict 导出。在 IIFE 场景中调用此方法时，该方法将返回打包的导出，同时将相应的全局变量恢复为其先前的值。

只有当 output.format 设置为 ['amd', 'cjs', 'iife', 'umd'] 中的一个，并且 output.externalLiveBindings 设置为 false 时，这个选项才会生效。

为了兼容性最大化，Rollup 默认会从外部模块重新导出 __proto__。但是，对于常见的使用场景，我们强烈建议将这个值设置为 false，因为这样可以有效地减小输出文件的大小。

该选项值为 false 时禁用所有 chunk 名称的清理（移除 \0, ? 和 * 字符）。

值也可以是一个函数，以允许自定义的 chunk 名称的清理。

该选项用于决定是否在生成非 ES bundle 的顶部包含“use strict”用法。严格地讲，ES 模块 总是 使用严格模式，所以不要无缘无故禁用该选项。

在导出 system 模块格式时，该选项将代替空的 setter 函数，以 null 形式简化输出。该选项仅在 SystemJS 6.3.3 及以上版本中支持。停用这个选项，可以输出旧版 SystemJS 支持的空函数。

当该选项值为 false 时，引用的文件为软链接实际指向的文件。当该选项值为 true 时，引入的文件为软链接所在目录的文件。为了更好的解释，思考以下例子：

如果 preserveSymlinks 值为 false，那么从 /main.js 将会输出“next to original”，因为它将使用软链接文件的位置来解决其依赖。然而，如果 preserveSymlinks 值为 true，那么它将会输出“next to linked”，因为软链接将无法正确解析。

如果该选项值为 true，那么从未定义绑定的文件中引入依赖时，打包不会失败。相反，将为这些绑定创建值为 undefined 的新变量。

该选项用于决定是否应用除屑优化（tree-shaking），并微调除屑优化的过程。该选项的值设置为 false 时，Rollup 将生成更大的 bundle，但是可能会提高构建性能。你也可以从三个预设中选择一个，如果有新的选项加入，就会自动更新：

如果你发现由除屑优化算法造成的 bug，请给我们提 issue！将此选项的值设置为对象意味着启用除屑优化，并启用以下选项：

如果该选项值为 false，则忽略注释中的注解提示：

包含 @__PURE__ 或 #__PURE__ 的注释标记特定的函数调用或构造函数调用为无副作用。这意味着 Rollup 将除屑优化，即移除调用，除非返回值在一些未除屑优化的代码中被使用。这些注解需要紧跟在调用调用之前才能生效。以下代码将完全除屑优化，除非将该选项设置为 false，否则它将保持不变。

这样的标记被认为是 有效的，如果它直接在函数调用或构造函数调用之前，并且只被空格或注释与被调用者分隔。唯一的例外是括号，它包裹了一个调用或调用。

无效的注解将被删除，并且 Rollup 会发出警告。有效的注解将保留在代码中，除非它们的函数调用或构造函数调用也被删除。

包含 @__NO_SIDE_EFFECTS__ 或者 #__NO_SIDE_EFFECTS__ 的注释标记函数声明本身是无副作用的。当一个函数被标记为没有副作用时，所有对该函数的调用都将被认为是没有副作用的。下面的代码将被完全除屑优化，除非将该选项设置为 false，否则它将保持不变。

如果一个模块将此选项设置为 false 并从另一个模块重新导出变量，而且该变量被使用了，则扫描重新导出模块是否存在副作用的问题取决于变量的重新导出方式：

请注意，尽管名字有点误导，但此选项不会向没有副作用的模块“添加”副作用。重要的是，例如，因为你需要这个模块来跟踪依赖关系，而将空模块“包含”在 bundle 中，则插件接口允许你通过 resolveId，load 或 transform 钩子将模块指定为不被除屑优化删除。

该选项可以选择上面列出的预设之一，同时覆盖一些选项。

如果该选项值为 true，则保留未使用的属性读取，这会被 Rollup 确定为具有副作用。这包括访问 null 或 undefined 的属性，或通过属性访问触发显式 getter。请注意，这并不包括解构赋值或对象上当作函数参数传递的 getter。

如果值为 false，则假定读取对象的属性将永远不会有副作用。根据你的代码，禁用该属性能够显著缩小 bundle 的大小，但是如果你依赖了 getters 或非法属性访问的造成的错误，那么可能会破坏该功能。

如果值为 'always'，则假定所有成员属性访问，包括解构赋值，都具有副作用。建议对依赖具有副作用 getter 的代码使用此设置。它通常会导致更大的包大小，但比完全禁用 treeshake 更小。

默认情况下，Rollup 假定在进行除屑优化时，很多运行时内置的全局变量的行为均符合最新规范，并且不会引发意外错误。为了支持，像依赖于抛出错误的特征检测工作流，Rollup 将默认禁用 try 语句中的除屑优化。如果函数参数在 try 语句中被使用，那么该参数也不会被优化处理。如果你不需要此功能，想要在 try 语句中使用除屑优化，则可以设置 treeshake.tryCatchDeoptimization 为 false。

因为访问不存在的全局变量会引起错误，所以默认情况下 Rollup 保留所有对非内置全局变量的访问。该选项的值设置为 false 可以避免该检查。对于大多数代码库而言，这样做很可能更安全。

在这个例子中，最后一行将被始终保留，用于访问 element 属性，但如果 angular 值比如为 null，也可能抛出错误。为了避免这种情况的检查，可以设置 treeshake.propertyReadSideEffects 为 false。

这些选项反应了尚未完全确定的新功能。因此，它们的可行性、行为和用法在次要版本（minor version）中可能发生变化。

该选项用于确定在多少次执行以后，应该删除不再被插件使用的静态缓存。

该选项值为 true 时，将会在每个文件发现的第一个副作用打印到控制台。这对于计算哪些文件有副作用以及实际的副作用是什么非常有帮助。删除副作用可以改善除屑优化和 chunk 的生成，对于使 output.experimentalMinChunkSize 发挥作用至关重要。

不过，该选项只记录顶层的语句。有时，例如在立即调用函数表达式的情况下，实际的副作用可能隐藏在一个嵌套表达式中。

该选项用于为代码分割设置一个以字节为单位的最小 chunk 大小。当该值设置为默认值 1 时，Rollup 将尝试将不包含代码（仅包含导入和重新导出）的块合并到其他 chunk 中。仅当合并不会改变任何入口加载时执行的副作用时，才会执行合并。对于值为 1 的情况，仅允许执行不增加任何入口加载的代码量的合并。

较大的值将尝试将低于限制的任何 chunk 合并到其他 chunk 中。在这种情况下，可能会加载一些不必要的代码，不过也是可以接受的。同时该算法进行合并时总是尽可能地减少不必要的代码。

不幸的是，由于块的渲染插件（如最小化压缩工具）运行之前，chunk 大小是在测量之前进行的，这意味着您应该给出足够高的限额。在计算大小时，它也将考虑对顶层语句的除屑优化。

该选项用于决定是否收集打包执行耗时。当使用命令行或者配置文件时，将会展示与当前构建过程有关的详细指标。当在 JavaScript API 中使用时，返回的 bundle 对象将包含额外的 getTimings() 函数，可以随时调用该函数来获取所有累计的指标。

getTimings() 函数返回以下对象形式：

对于每个键的值，是一个数组，其中，第一个数值表示经过的时间，第二个数值表示内存消耗的变化，第三个数值表示此步骤完成后的总内存消耗。这些步骤的顺序是通过 Object.keys 确定的。顶层的键以 # 开头，包含嵌套步骤的耗时，例如，在上面例子中，耗时 698ms 的 # BUILD 步骤包含了耗时 539ms 的 ## parse modules 步骤。

该选项用于指定观察模式（watch mode）的选项，或防止 Rollup 配置被观察。指定该选项为 false，将仅对 Rollup 使用数组配置时有效。在这种情况下，Rollup 配置将不会根据观察模式中的变更构建或重新构建，而是在 Rollup 运行时定期构建：

这些选项仅在使用 --watch 标志或使用 rollup.watch 运行 Rollup 时生效。

该选项用于配置 Rollup 触发重新构建到执行下一次构建需要等待的时间，以毫秒为单位。默认情况下，Rollup 不会等待，但是在 chokidar 实例中配置了一个小的防抖定时器（debounce timeout）。该选项的值大于 0 将意味着如果配置的毫秒数没有发生变化，Rollup 只会触发一次重新构建。如果观察到多个配置变化，Rollup 将使用配置的最大构建延迟。

在观察选项中，该选项是可选对象，将传递给 chokidar 实例。查阅 chokidar 文档 以了解可用的选项。

该选项用于决定是否在触发重新构建时清空屏幕。

该选项用于指定不需要被 watch 的文件：

该选项用于限制只能对指定文件进行观察。请注意，该选项只过滤模块图中的文件，不允许添加额外的观察文件：

该选项用于决定是否在触发重新构建时跳过 bundle.write() 步骤。

☢️ 这些选项已经废弃，可能从未来的 Rollup 版本中移除。

使用 output.externalImportAttributes 选项代替。

是否在输出中为外部导入添加导入断言，如果输出格式为 es。默认情况下，断言来自输入文件，但是插件可以稍后添加或删除断言。例如，import "foo" assert {type: "json"} 将导致相同的导入出现在输出中，除非将该选项设置为 false。请注意，模块的所有导入都需要具有一致的断言，否则将发出警告。