はじめに

リポジトリのクローン

git clone -c core.longpaths=true git@github.com:oxc-project/oxc.git

プロジェクトの設定

Rust のインストール

まだ Rust をインストールしていない場合は、公式の説明に従って、Rust をインストールしてください。

Rust をインストールした後、プロジェクトのルートディレクトリで以下のコマンドを実行します：

rustup show

rustup show は ./rust-toolchain.toml ファイルを読み取り、このプロジェクト用に適切な Rust ツールチェーンおよびコンポーネントをインストールします。

cargo binstall

OXC の開発にはいくつかの Cargo ツールが必要です。cargo binstall を使用することをお勧めします。これは、Rust のバイナリを簡単にインストールできる仕組みであり、cargo install でソースからビルドするよりも高速です。

cargo install cargo-binstall

また、事前コンパイルされたバイナリ をダウンロードし、~/.cargo/bin に保存することもできます。

just

OXC では just が利用されており、プロジェクト固有のコマンドを保存して実行する便利な方法です：

cargo binstall just -y

CMake のインストール

公式 ウェブサイト からダウンロードして、CMake をインストールしてください。

Homebrew を使っているユーザーは、以下のようにインストールできます：

brew install cmake

pnpm のインストール

pnpm（node.js のパッケージマネージャーで、npm と似ています）をインストールするには、公式 ウェブサイト の手順に従ってください。

依存関係

プロジェクトルートの justfile で以下のコマンドを実行して、依存関係をインストールします：

just init

just を実行すると、利用可能なコマンドの一覧を確認できます。

すべてのプロジェクトが正常にビルド・実行されることを確認するには、just ready（または短縮形の just r）を実行してください。

macOS: より速いコンパイル

macOS には初回実行時に実行ファイルをマルウェア検査するセキュリティ機能「XProtect」があります。この機能は、特にビルドスクリプトやテスト実行ファイルの場合、Rust のビルドを著しく遅くすることがあります。システム設定でターミナルを「開発者ツール」として追加することで、コンパイルを高速化できます：

1. システム設定 > プライバシーとセキュリティ > 開発者ツール に移動
2. あなたのターミナルアプリ（Terminal、iTerm など）を追加
3. ターミナルアプリを再起動

注意: この操作はオペレーティングシステムのセキュリティ機能を無効化します。信頼できる環境であると確信できる場合にのみ実行してください。

詳細情報: https://nnethercote.github.io/2025/09/04/faster-rust-builds-on-mac.html