命令行界面

Rolldown 支持命令行界面 (CLI) 快速打包应用程序。您既可以指定配置，也可以直接使用 CLI 的选项。

配置文件

可以使用 -c 或 --config 选项指定配置文件。配置文件必须是一个导出配置对象的 JavaScript 文件。

由于 API 限制，如果您打算忽略配置文件名，建议将选项放在最后。

rolldown -c
# OR
rolldown -c rolldown.config.mjs

目前，rolldown.config.js 文件可以忽略不计。

通用 CLI 选项

为简单起见，我们在此手动展示最流行的选项。将来的增强功能将自动生成其他选项。

--dir / -d

指定输出目录。

rolldown main.ts -d dist

如果该目录不存在，Rolldown 将自动创建该目录。

--external / -e

排除的模块 ID。

例如，如果您希望从 main.ts 中排除 electron 模块，可以使用以下命令

rolldown main.ts -e electron

此命令将从捆绑输出中排除 electron 模块。请注意，我们目前仅支持 CLI 中模块 ID 的 string 值。

—format / -f

捆绑文件的输出格式接受以下格式

• esm：ECMAScript 模块，包括 import、export 和其他关键字。
• cjs：CommonJS 模块，包括 require、module.exports 和其他关键字。
• iife：立即调用的函数表达式，包括 window、global 和其他关键字。

将来会支持更多格式。

—minify 或 -m

最小化输出文件。

rolldown main.ts -m

Rolldown 将使用 oxc 中的 oxc_minify 工具来缩小输出文件。此过程非常高效。

—sourcemap / -s

生成源映射文件。

• 如果您打算内联源映射，请使用

  rolldown main.ts -s inline

• 如果您希望发出源映射文件，请使用

  rolldown main.ts -s

  切记按照 API 限制在命令末尾传递参数。我们将在将来尝试解决此问题。