시작하기

저장소 클론

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

프로젝트 설정

Rust 설치

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 설치

pnpm(Node.js의 패키지 매니저, npm과 유사)를 공식 사이트의 지침에 따라 설치하세요.

종속성 설치

프로젝트 루트의 justfile에서 다음 명령어를 실행하여 종속성을 설치하세요:

just init

just를 실행하면 사용 가능한 명령어 목록을 확인할 수 있습니다.

전체 프로젝트가 올바르게 빌드되고 실행되는지 확인하려면 just ready(또는 단축형 just r)을 실행하세요.

macOS: 더 빠른 빌드

macOS에는 처음 실행 시 실행 파일을 악성코드 여부로 스캔하는 방화벽 기능인 XProtect가 있습니다. 이 기능은 특히 빌드 스크립트와 테스트 실행 파일의 경우 빌드 속도를 크게 저하시킬 수 있습니다. 시스템 설정에서 터미널을 "개발자 도구"로 추가함으로써 빌드 속도를 향상시킬 수 있습니다:

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

참고: 이 조치는 운영체제 보안 기능을 비활성화합니다. 안전하다고 느끼는 경우에만 수행하세요.

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