建立及執行

在繼續之前，請確定您已完成 設定過程。

just 是什麼？

just 是 rolldown 儲存庫的命令執行器。它可以在一個命令下建置、測試和執行專案的程式碼檢查。

用法

您只要執行 just 命令，就能取得可用命令清單。

重要命令

• just roll - 從頭建立 Rolldown 並執行所有測試和檢查。
• just test - 執行所有測試。
• just lint - 執行程式碼檢查。
• just fmt - 修正格式問題。
• just fix - 修正格式和程式碼檢查問題。

大多數命令都會同時執行 Rust 和 Node.js 腳本。若只想針對其中一個語言，請在 just 命令後加上 -rust 或 -node。例如，just lint-rust 或 just check-node。

提示

在開發流程中，just roll 可能會是最常使用的命令。它會在您進行任何變更時自動檢查所有功能是否正常，無需多費心思。

透過這個方式，您可以即時在本地端發現錯誤，而不用將變更推送到 GitHub 並等待 CI 處理。

• just roll-rust - 只執行 Rust 檢查。
• just roll-node - 只執行 Node.js 檢查。
• just roll-repo - 檢查與程式碼無關的問題，例如檔案名稱。

建立

Rolldown 建構在 Rust 和 Node.js 上，因此建立過程包含編譯 Rust 函式庫封裝，編譯 Node.js 套件，以及將兩者結合在一起的橋接部分。橋接部分也是 Node.js 套件，但是編譯橋接部分也會觸發編譯 Rust 函式庫封裝。

幸運的是，NAPI-RS 封裝了編譯橋接部分的過程，我們無需在意細節。

rolldown

要編譯 rolldown 套件，有以下兩個命令

• just build/just build native
• just build native release（如果要執行效能測試，這個很重要）

它們會自動編譯 Rust 函式庫封裝和 Node.js 套件。因此，無論您做了什麼變更，您都可以使用這些命令建立最新的 rolldown 套件。

WASI

Rolldown 將 WASI 視為一個特殊平台，以此支援 WASI。因此，我們仍然使用 rolldown 套件來發佈 Rolldown 的 WASI 版本。

要編譯 WASI 版本，您可以執行以下命令

• just build wasi
• 只需建立 Wasi 版本（如果要執行基準測試，則很重要）

建立 Wasi 版本時，會移除 Rolldown 的原生版。我們專門設計本地建置流程，即你建立原生版或 Wasi 版本。儘管 NAPI-RS 支援混合使用，但無法同時混合使用這兩種版本。

執行

rolldown 套件會透過 pnpm 工作區自動連結到 `node_modules`。

建立 rolldown 套件後，你可以執行下列指令來執行它

pnpm rolldown