시작하기

저장소 클론

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

프로젝트 설정

Rust 설치

Rust가 없다면 공식 안내에 따라 설치합니다.

설치 후 프로젝트 루트에서:

rustup show

rustup show는 ./rust-toolchain.toml을 읽어 이 프로젝트에 맞는 Rust 툴체인과 컴포넌트를 설치합니다.

cargo binstall

OXC 개발에 필요한 Cargo 도구가 있으며, 소스에서 cargo install로 빌드하는 것보다 빠르고 부담이 적은 cargo binstall 사용을 권합니다.

cargo install cargo-binstall

미리 빌드된 바이너리를 받아 ~/.cargo/bin에 둘 수도 있습니다.

just

OXC는 프로젝트 전용 명령을 저장·실행하는 just를 사용합니다.

cargo binstall just -y

CMake 설치

CMake는 공식 사이트에서 받아 설치합니다.

Homebrew 사용자는:

brew install cmake

pnpm 설치

Node.js용 패키지 매니저인 pnpm은 공식 설치 안내를 따릅니다.

의존성

프로젝트 루트 justfile에 있는 다음 명령으로 의존성을 설치합니다.

just init

just만 실행하면 사용 가능한 명령 목록을 볼 수 있습니다.

just ready(또는 짧게 just r)로 전체 빌드·실행이 정상인지 확인할 수 있습니다.

macOS: 더 빠른 컴파일

macOS에는 XProtect라는 백신 기능이 있어 실행 파일을 처음 돌릴 때 검사합니다. Rust 빌드 특히 빌드 스크립트와 테스트 실행 파일을 크게 느리게 할 수 있습니다. 시스템 설정에서 터미널을 "개발자 도구"로 추가하면 컴파일을 빠르게 할 수 있습니다.

1. 시스템 설정 > 개인 정보 보호 및 보안 > 개발자 도구 열기
2. 터미널 앱(Terminal, iTerm 등) 추가
3. 터미널 앱 재시작

참고: OS 보안 기능이 일부 비활성화됩니다. 트레이드오프를 이해한 경우에만 하세요.

자세히: https://nnethercote.github.io/2025/09/04/faster-rust-builds-on-mac.html