Начало работы

Клонирование репозитория

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

Настройка проекта

Установка Rust

Если Rust ещё не установлен, следуйте официальной инструкции.

В корне проекта выполните:

rustup show

Команда прочитает ./rust-toolchain.toml и установит нужный toolchain и компоненты.

cargo binstall

Для разработки OXC нужны дополнительные утилиты Cargo; удобнее ставить их через cargo binstall — быстрее, чем каждый раз собирать через cargo install:

cargo install cargo-binstall

Либо скачайте готовый бинарник в ~/.cargo/bin.

just

В OXC используется just для типовых команд проекта:

cargo binstall just -y

CMake

Установите CMake с официального сайта.

Пользователи Homebrew:

brew install cmake

pnpm

Установите pnpm по инструкции.

Зависимости

В корне репозитория:

just init

Список команд — just.

Для проверки полной сборки: just ready (кратко just r).

macOS: ускорение сборки

На macOS XProtect при первом запуске сканирует бинарники и может сильно замедлять сборку Rust. Можно добавить терминал в «Developer Tools» в настройках системы:

1. Системные настройки → Privacy & Security → Developer Tools
2. Добавьте приложение терминала (Terminal, iTerm и т.д.)
3. Перезапустите терминал

Внимание: это ослабляет один из механизмов ОС. Делайте только если осознаёте риск.

Подробнее: https://nnethercote.github.io/2025/09/04/faster-rust-builds-on-mac.html