命令列介面

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 的 字串 值。

—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 限制。我們會嘗試在未來修復這個問題。