设置项目

必备条件

只需少数工具即可构建和运行 Rolldown。您需要

• 通过 rustup 安装 Rust
• 安装 just

您可以通过运行以下命令或遵循官方 指南 来快速安装 just

Npm

npm install --global just-install

Pnpm

pnpm --global add just-install

Yarn

yarn global add just-install

Homebrew

brew install just

Cargo

cargo install just

• 安装 Node.js >= 20.11 / 21.2

just setup

在首次签出代码库后，您需要做的就是运行存储库根目录中的 just setup。

如果您在最后看到 ✅✅✅ 安装完成！，则表示您拥有构建和运行 rolldown 所需的一切。

您可以运行 just roll 来验证是否一切正常工作。

提示

• just roll 可能需要一段时间才能运行，因为它将从头开始构建 rolldown 并运行所有测试。
• 如果您想了解 just setup 在后台做了什么，您可以查看存储库根目录中的 justfile。

现在，您可以转到下一章 构建和运行。如果您希望深入了解设置过程，请继续阅读。

深入解析

本部分将更详细地介绍构建和运行 Rolldown 所需的已安装工具和依赖项。

设置 Rust

Rolldown 构建在 Rust 上，并且要求环境中存在 rustup 和 cargo。你可以 从官方网站安装 Rust。

设置 Node.js

Rolldown 是使用 NAPI-RS 构建的 npm 包，并且发布到 npm 注册表中，因此它需要 Node.js 和 pnpm（用于依赖项管理）。

我们建议使用版本管理器（如 nvm 或 fnm）来安装 Node.js。请务必安装并使用 Node.js 版本 18.18.0+，这是本项目的要求。如果你已经在使用你选择的 Node.js 版本管理器以及满足要求的 Node.js 版本，那么可以跳过此步骤。

设置 pnpm

我们建议通过 corepack 启用 pnpm，这样在使用本项目时可以自动使用 pnpm 的正确版本

corepack enable

来验证所有设置是否正确。