[Rust 공식문서 한국어 정리] 84. Rust rustup 가이드

[Rust 공식문서 한국어 정리] 84. Rust rustup 가이드



원문 제목: rustup — The Rust toolchain installer

작성자: Rustup Team



━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📌 1. 서론 — 이 문서가 다루는 내용

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━



이 문서는 Rust의 공식 툴체인 관리자인 rustup을 소개합니다.

Rust 컴파일러, 표준 라이브러리, Cargo, Clippy, rustfmt 등의 도구를 설치하고, 여러 버전을 전환하는 방법을 다룹니다.

Stable, Beta, Nightly 채널 관리, 크로스 컴파일 타겟 추가, 그리고 커스텀 툴체인 설정을 중심으로 설명합니다.

팀 단위 개발 환경 표준화와 CI에서의 rustup 활용법도 포함합니다.

Rust를 시작하는 모든 개발자와, 여러 버전을 관리해야 하는 팀에게 필수적인 가이드입니다.



━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔑 2. 핵심 개념 4가지

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━



① rustup: Rust 툴체인 설치 및 버전 관리를 담당하는 공식 도구입니다.

② Channel: Stable, Beta, Nightly 세 가지 릴리스 채널로, 각각의 성숙도와 기능을 제공합니다.

③ Target: 크로스 컴파일을 위한 타겟 플랫폼(예: wasm32-unknown-unknown)을 추가/관리합니다.

④ Toolchain Override: 프로젝트별로 rust-toolchain.toml을 사용하여 특정 Rust 버전을 고정합니다.



━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📖 3. 주요 내용 상세

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━



rustup은 https://rustup.rs에서 설치하며, Windows, macOS, Linux를 모두 지원합니다.

rustup default stable로 기본 툴체인을 설정하고, rustc --version으로 현재 버전을 확인합니다.



채널 관리는 rustup update stable과 rustup install nightly처럼 간단합니다.

rustup default nightly로 기본 채널을 전환하고, rustup run nightly cargo build로 일회성 실행도 가능합니다.



크로스 컴파일 타겟은 rustup target add로 설치합니다.

rustup target add wasm32-unknown-unknown으로 WebAssembly 타겟을,

rustup target add thumbv7em-none-eabihf로 ARM 임베디드 타겟을 추가합니다.



rust-toolchain.toml로 프로젝트별 툴체인을 고정합니다.

[toolchain] channel = "1.70.0" components = ["clippy", "rustfmt"]

이 파일이 있는 디렉토리에서는 자동으로 지정된 버전과 컴포넌트가 사용됩니다.



컴포넌트는 rustup component add로 개별 설치합니다.

clippy, rustfmt, rust-src, rust-docs, miri 등의 컴포넌트를 선택적으로 추가할 수 있습니다.



━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🛠 4. 실전 활용

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━



프로젝트 루트에 rust-toolchain.toml을 두고, 팀원 모두가 동일한 Rust 버전을 사용하도록 합니다.

CI에서 rustup show로 rust-toolchain.toml을 자동 인식하여, 지정된 버전을 설치합니다.

Nightly 컴포넌트(cargo-fuzz, Miri)가 필요할 때만 rustup run nightly를 사용합니다.



━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ 5. 정리

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━



rustup은 Rust 개발 환경의 중심으로, 툴체인 설치와 버전 관리를 담당합니다.

채널, 타겟, 컴포넌트, 프로젝트별 오버라이드를 통해 유연하고 일관된 개발 환경을 구축합니다.

rust-toolchain.toml로 팀의 Rust 버전을 고정하여, "Works on my machine" 문제를 원천 차단하세요.



━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔗 출처 링크

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━



원문: https://rust-lang.github.io/rustup/

rustup.rs: https://rustup.rs/



#Rust #rustup #Toolchain #VersionManagement #CI #Development #번역